termstats

Terminal · Open source · Free

The machine,
at a glance.

termstats is a system dashboard for the terminal: CPU, memory, network, disks and processes with live charts. One file for macOS, Linux or Windows — no account, no configuration, no network access.

v0.12.0 · 0.3 MB · 17 Nov 2026 · macOS · Apple silicon

Runs where your terminal runs

Everything about the machine. Almost nothing from it.

The whole machine on one screen

CPU load per core, memory and swap, network rates, disks and the busiest processes, with history charts for CPU and network. One colour ramp from cool to hot runs through every bar and number.

Light on the machine it watches

On macOS and Linux the live dashboard is a native binary written in Rust: measured at about 0.3 % of one CPU core and 7 MB of memory. A monitor should not show up in its own process list.

Fits the terminal you have

The layout follows the window and drops whole sections instead of cutting them. Six colour themes; where a terminal cannot draw braille or 24-bit colour, termstats falls back to blocks, ASCII, 256 or 16 colours, and it honours NO_COLOR.

Sound, measured in the terminal

The Python program and the Windows build listen to the microphone on request: -eq is a 28-band spectrum analyser, -bpm finds the tempo, -db shows the level, -x shows level and tempo together. Nothing is recorded.

Remembers what the machine does

termstats record install starts a background service on macOS and Linux that writes one line per minute to a local log — measured at 0.024 % of one CPU core. The log stays on your disk and record purge deletes it.

Tells you which computer fits

After 14 days of history, termstats recommend names machines in three tiers — just enough, fits, with reserve — plus a Linux alternative, each with the reason in your own numbers. The catalogue of Macs and Linux hardware ships with every release.

Install in three steps

  1. 1

    Download the file for your system

    The button above picks it; the chips offer the other platforms. On macOS and Linux one line does everything: curl -fsSL https://github.com/pepperonas/termstats/releases/latest/download/install.sh | sh

  2. 2

    Unpack it

    macOS and Linux: tar -xzf termstats-native-*.tar.gz, then move termstats-native into a folder on your PATH, for example ~/.local/bin. Windows: unpack the zip anywhere.

  3. 3

    Run it

    termstats-native on macOS and Linux, termstats.exe in Windows Terminal. Esc or q leaves. A file downloaded with a browser on macOS needs xattr -d com.apple.quarantine termstats-native once.

Check what you downloaded

termstats-native-aarch64-apple-darwin.tar.gz
59c661c50236167ac901557d4428bf0e1d4a9f29c1b8a30bb856a618b47fbdf3
termstats-native-x86_64-unknown-linux-musl.tar.gz
68c9029df3dedff44dcad2157c262044ec0969b658f4df8c7cf47d9f81082d44
termstats-windows-x86_64.zip
1b6bed8ab806d1d92924bc8b4f0cbaba50b0157bbb1eda9c474fe761343dd9c5
termstats-native-x86_64-apple-darwin.tar.gz
09913ce178493980d35abab1db85881b8dc14e80b158a8ec0472efc9e4b1419b
termstats-native-aarch64-unknown-linux-musl.tar.gz
dc2c51d5de4fbb0931888cfb74014947744e99d6cfbfc60ee4d5c80e6cb50548
termstats-0.12.0-py3-none-any.whl
7224d7fde30fe0d979ee49d485fff9f1c0289b44c40cb17fc6f749f759c93522

Compare with shasum -a 256 <file> (Windows: certutil -hashfile <file> SHA256). Every release also carries a SHA256SUMS file, and the install script checks against it.

termstats is two programs: the native binary (macOS, Linux) and the Python program (every platform, as termstats.exe on Windows). Every release is built by GitHub Actions from the public source code. Older releases are on GitHub.

Questions

Is termstats free?

Yes. It is free and open source under the MIT licence — no account, no tracking, and no paid version with more features.

Why is it not on PyPI or Homebrew?

termstats is distributed through GitHub Releases and this page only. Each release has a ready file per platform, so no package manager is needed; with Python you can still run pipx install on the wheel.

What do I need?

A terminal. The native binary runs on macOS (Apple silicon or Intel) and Linux (x86-64 or ARM64, any distribution) and needs nothing else. The Windows file needs 64-bit Windows 10 or 11; Windows Terminal draws it best. The Python wheel needs Python 3.9 or later.

How do I update?

Download the new file and replace the old one, or run the install script again. termstats never contacts the network, so it does not check for updates itself; this page always shows the newest release.

What is the difference between the downloads?

The macOS and Linux files are the native binary: the live dashboard, the history recorder and the recommendation. The Windows file and the Python wheel are the Python program: the same dashboard plus the microphone screens, the demo and snapshots, but without recorder and recommendation on Windows. With both installed on macOS or Linux, termstats hands the live dashboard to the native binary by itself.

Is the file genuine?

Every release is built by GitHub Actions from the public source code, and this page lists the SHA-256 of each file. The files are not code-signed: macOS quarantines a browser download and Windows SmartScreen may ask once — compare the checksum first.

Like the app?

termstats is free, has no ads and stays that way. A small donation keeps it maintained — and a review of celox.io on Google helps just as much.

Licence

MIT License

Copyright (c) 2026 Martin Pfeffer

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Changelog

on GitHub

Loading…