btop
A terminal resource monitor with graphs and a process list
Written by @iluxav from the project's code and releases, not by its maintainers. Last updated for v1.4.8 (2026-10-25), so it may lag behind newer releases.
Thanks. Marked useful.
Thanks. The report went to osfeed, and the line gets checked against the repository.
See CPU, memory, disk, network, GPU and battery use in one terminal view, and filter, sort, renice or kill processes with keys or the mouse.
What you can do with btop
Filter, sort and view processes as a tree, see details of one, and send it any signal.
1 other tool for: Kill a process from the terminalWrong?
Monitor GPU usage, memory and power on supported Linux GPUs and Apple Silicon Macs.
1 other tool for: Watch GPU usageGood to know
Requires a GPU-enabled build. Linux AMD sysfs fallback needs the amdgpu driver; available metrics depend on exposed sensors. NVIDIA needs NVML. macOS GPU monitoring requires Apple Silicon.
Wrong?
See battery charge and time remaining.
1 other tool for: See battery status in the terminalWrong?
Change every option from an in-app menu, pick themes and graph symbols, and switch between saved layout presets.
3 other tools for: Theme your terminalWrong?
Run the same monitor on Linux, macOS, FreeBSD and OpenBSD.
Wrong?
Automatically collapse processes with many children when entering tree view.
Good to know
Set `proc_tree_auto_collapse` to a threshold from 1 to 10000; 0 disables it by default. Root processes and their direct children are excluded.
Wrong?
Before you upgrade btop
Newest firstThemes are saved by filename when possible and sorted alphabetically. `=` also increases the update interval; in selected process trees it expands the process instead.
Read the evidence
Wrong?
`only_physical` now controls disk filtering on NetBSD; disabling it allows nonphysical filesystems to appear.
Read the evidence
Wrong?
Decimal kilo units now display as `kB` and `kb` instead of `KB` and `Kb`.
Read the evidence
Wrong?
Show 5 older
Update timestamp parsers from `YYYY-MM-DD (HH:MM:SS)` to ISO 8601 `YYYY-MM-DDTHH:MM:SSZ`.
Read the evidence
Wrong?
Building from source now needs a C++23 compiler: GCC 14 or Clang 19 or newer.
Read the evidence
Wrong?
100 ms is now the shortest update rate; lower values are not used.
Read the evidence
Wrong?
Command-line flags were renamed: `--tty_on` is now `-t/--tty`, `+t/--tty_off` is `--no-tty`, `-lc` is `-l/--low-color`, `--utf-force` is `--force-utf`. Update scripts and launchers that pass the old names.
Read the evidence
Wrong?
Log files are now written under `$XDG_STATE_HOME`.
Read the evidence
Wrong?
btop release history 8
Monitor AMD integrated GPUs on Linux even when ROCm cannot enumerate them.
Details
An AMD sysfs fallback reads available GPU sensors, and `proc_tree_auto_collapse` sets a child-count threshold. Log timestamps now use ISO 8601; NetBSD honors `only_physical`.
Also: Auto-collapse busy process trees; fixes for macOS monitoring, ROCm 7 and custom config files; updated theme handling and log timestamps.
v1.4.8. Release binaries lack GPU support: compile with GPU support or use a suitable distribution package. No macOS or BSD binaries are provided in this release.
Seeded by @iluxav with Codex
Read the evidence
- aristocratos/btop/releases/tag/v1.4.8
- aristocratos/btop/blob/v1.4.8/src/linux/btop_collect.cpp
- aristocratos/btop/blob/v1.4.8/README.md
- aristocratos/btop/blob/v1.4.8/src/btop_shared.cpp
- aristocratos/btop/compare/v1.4.7...v1.4.8
- aristocratos/btop/blob/v1.4.8/src/btop_theme.cpp
- aristocratos/btop/blob/v1.4.8/src/btop_menu.cpp
- aristocratos/btop/blob/v1.4.8/src/btop_input.cpp
- aristocratos/btop/blob/v1.4.8/src/btop.cpp
- aristocratos/btop/blob/v1.4.8/CMakeLists.txt
- aristocratos/btop/blob/v1.4.8/src/netbsd/btop_collect.cpp
- aristocratos/btop/blob/v1.4.8/src/btop_tools.cpp
- aristocratos/btop/blob/v1.4.8/src/btop_log.cpp
Follow one process so it stays selected while the list re-sorts.
Details
Process following mode, Apple Silicon GPU support, a swap upload and download speed graph, the `E` key to expand or collapse all process trees, a menu option to turn presets off, and new themes.
v1.4.7.
Seeded by @iluxav with Claude Code
Change a process's priority (renice) without leaving btop.
Details
Renice processes, pause the process list, CPU frequency display modes, choose which GPU vendors to enable, container-aware CPU counts, `--themes-dir` and `--default-config` flags, and a `save_config_on_exit` option.
Also: Expand or collapse a process's children; drag scrollbars with the mouse; a toggle for terminal synchronization.
v1.4.6. Building needs GCC 14 or Clang 19 (C++23).
Seeded by @iluxav with Claude Code
Read the evidence
- aristocratos/btop/releases/tag/v1.4.6
- aristocratos/btop/pull/1268
- aristocratos/btop/pull/1306
- aristocratos/btop/pull/1274
- aristocratos/btop/pull/1277
- aristocratos/btop/pull/1220
- aristocratos/btop/pull/1218
- aristocratos/btop/pull/984
- aristocratos/btop/pull/1357
- aristocratos/btop/pull/1399
- aristocratos/btop/pull/1315
- aristocratos/btop/blob/v1.4.6/README.md
See how much power the CPU draws.
Details
CPU power draw in the CPU box, NVIDIA video encode and decode meters, and battery time-to-full on Linux.
v1.4.5.
Seeded by @iluxav with Claude Code
Start btop with a process filter already set.
Details
New `-f/--filter <filter>` flag; the update rate can no longer go below 100 ms.
v1.4.4.
Seeded by @iluxav with Claude Code
Point btop at another config file and set the update rate from the command line.
Details
A new command-line parser adds `-c/--config <file>` and `-u/--update <ms>` and renames several flags; logs move to `$XDG_STATE_HOME`; a menu option shows bitrates in base 10. Groups v1.4.1 and v1.4.2.
v1.4.1 and v1.4.2. Building with CMake needs CMake 3.25 or newer.
Seeded by @iluxav with Claude Code
Monitor Intel GPUs, and run btop on NetBSD.
Details
Intel GPU support, NetBSD support, and regex filtering in the process list.
v1.4.0.
Seeded by @iluxav with Claude Code
Starting point
See CPU, memory, disks, network and processes in one terminal view, driven by keys or the mouse.
Details
State as of v1.3.2: CPU, memory, disk I/O, network and battery boxes, a process list with filter, sort, tree view and signals, GPU boxes on Linux (keys 5 to 0), themes, presets and a menu for every config option.
Linux, macOS, FreeBSD and OpenBSD; distribution packages and release binaries.
Seeded by @iluxav with Claude Code