btop is a free resource monitor that runs in your terminal and shows what your computer is doing right now: CPU load per core, memory, disk speed and space, network traffic, battery and a sortable list of running processes, all as live graphs. Type btop and you get a full-screen dashboard you can click around with the mouse, filter by name, switch to a tree view, and use to stop a runaway process.
It earns its place as a friendlier replacement for top and htop, and it is handy on a remote server over SSH where there is no desktop app to open. Every option is in an in-app menu rather than only a config file, it ships with about 50 colour themes, and on Linux and Apple Silicon Macs it can show GPU usage too.
btop is the C++ rewrite of the same author's earlier bashtop and bpytop. It is Apache-2.0 licensed, maintained by the developer known as aristocratos with about 190 contributors, and has about 35,000 stars. Version 1.4.8 came out on 25 October 2026.
- Repository: github.com/aristocratos/btop
- Licence: Apache-2.0 (Apache License 2.0)
- Language: C++. Stars: 35.4K. Forks: 1,266. Last push: Nov 11, 2026.
- Scan: safe, Nov 16, 2026, commit 5d03929
Who it is for
Developers, sysadmins, homelab owners and anyone curious why their computer is slow. It runs on Linux, macOS and the BSDs from a terminal; Windows has a separate port, btop4win, which we did not scan.
Getting started
1. Install on macOS or Linux with Homebrew
brew install btop2. Or on Ubuntu and Debian
sudo apt install btop3. Start it. Press Esc or m for the menu, f to filter processes and q to quit
btopPackage managers install it without touching your shell files. From a release download, sudo make install copies it into /usr/local, and the optional sudo make setcap or sudo make setuid gives btop extra rights to read CPU power and Intel GPU data and to signal any process; setcap is the narrower of the two. Settings live in ~/.config/btop. Our scan covers the source code, not the prebuilt binaries.
Safety scan
We cloned aristocratos/btop at commit 5d03929 on Nov 16, 2026 and ran the checks described on the GitHub Tools page: credential patterns, decode-and-execute code, install-time scripts, committed binaries, risky CI workflows, every host the code talks to, known vulnerabilities in pinned dependencies, and project hygiene. A person read every hit. This is what we found.
- 0 secret hits and no committed binaries across 153 files and about 52,000 lines of C and C++, about half of it the bundled fmt text-formatting library in include/fmt.
- 0 pattern hits. Reading process, disk and network statistics is what a monitor does; we found no code that sends them anywhere.
- No install script. The Makefile's install target copies the program and themes into /usr/local, with sudo when needed. The optional setcap and setuid targets give btop elevated rights so it can read power and Intel GPU data and signal other users' processes; setcap grants less than setuid.
- No advisories reported, with one caveat: btop has no package lockfile, and its two bundled libraries, fmt and widechar_width, sit in include/, which the advisory check does not cover.
- The hosts in the code are licence headers, the fmt documentation and GitHub. Four workflows with no default permissions, no pull_request_target, and all 12 third-party actions pinned to commits; zizmor audits the workflows and Renovate keeps them updated. No security policy file, CodeQL or OpenSSF Scorecard score.
What the scanner counted
| Check | Result |
|---|---|
| Secrets | None found. |
| Suspicious code | None found. |
| Install-time code | None: nothing runs at install beyond the package manager itself. |
| Committed binaries | None. |
| CI workflows | 4 workflows. None use pull_request_target. 0 of 12 third-party actions pinned to a tag rather than a commit. |
| Network hosts | 14 distinct hosts referenced from source; most often www.apache.org, github.com, gcc.gnu.org, fmt.dev. No URLs to bare IP addresses. |
| Known vulnerabilities | No lockfile to check: dependencies are declared as ranges, so what gets installed is whatever is current on the day. |
| Project hygiene | Has automated dependency updates, licence file, contributing guide. Missing security policy, CodeQL. |
| OpenSSF Scorecard | Not scored: the project is not in Scorecard's weekly index. |
By the numbers
| Stars | 35.4K |
|---|---|
| Forks | 1,266 |
| Contributors | 191 |
| Commits | 1,693 |
| Open issues | 492 |
| Open pull requests | 121 |
| Releases | 56 |
| Latest release | v1.4.8 |
| Licence | Apache-2.0 |
| Main language | C++ |
| Project age | 5 years |
| Last push | Nov 11, 2026 |
| Tracked files | 153 |
| Lines of code | 52.4K |
| Checkout size | 3 MB |
Lines by language: C/C++ header 27.6K, C++ 19.8K, Markdown 2,648, C 1,631, YAML 637, CMake 96.
Questions
Is btop free?
Yes. It is free and open source under the Apache 2.0 licence. The author accepts optional donations through GitHub Sponsors, PayPal and Ko-fi.
btop or htop?
btop if you want graphs for CPU, disks and network, mouse support and themes on one screen. htop is lighter and already installed on more servers. Both are free.
Does btop work on Windows?
Not this version. It runs on Linux, macOS, FreeBSD, NetBSD and OpenBSD. The same author's btop4win is a separate Windows port that we did not scan.
Does btop send my data anywhere?
No. It reads your system's statistics locally and draws them in the terminal. We found no network code.
How do I uninstall btop?
Run brew uninstall btop or sudo apt remove btop, depending on how you installed it. A release install comes out with sudo make uninstall.
This post is part of GitHub Tools, where every repository is cloned and scanned before it is written up. The scan is a snapshot of one commit on one day; the repository has moved on since, so check it before you install.
