Index

• News
• Documents
• Description
• Features
• Themes
• Support and funding
• Prerequisites (Read this if you are having issues!)
• Screenshots
• Keybindings
• Installation Linux/macOS
• Compilation Linux
• Compilation macOS
• Compilation FreeBSD
• Compilation NetBSD
• Compilation OpenBSD
• Testing
• GPU compatibility
• Installing the snap
• Configurability
• License

If you are considering donating, please first consider donating to:

News

22 March 2026

Updated contributing guidelines for AI generated code:

• Submissions where any of the code is AI generated must be marked with [AI generated].

(When code is generated by prompting either directly to an LLM or through "comment prompting".)

• Not needed when AI suggestions is used in "autocomplete" mode only for boilerplate or other repetitive code.

• Failure to disclose the use of AI in a PR will result in a closed PR and deliberately trying to obfuscate the use of AI will result in your account getting blocked from contributing again.

• "Vibe coded" PR's where it seems like the author doesn't understand the generated code will be dismissed.

4 December 2025

Since there is a increasing amount of AI generated/assisted PR's, the following guidelines have been added to CONTRIBUTING.md:

• Submissions where the majority of the code is AI generated must be marked with [AI generated].

• "Vibe coded" PR's where it seems like the author doesn't understand the generated code will be dismissed.

22 September 2024

Btop release v1.4.0

Intel GPU support added, note that only GPU utilization, power usage and clock speed available to monitor. Thanks to @bjia56 for contributions.

NetBSD support added. Thanks to @fraggerfox for contributions.

See CHANGELOG.md and latest release for detailed list of new features, bug fixes and new themes.

7 January 2024

Btop release v1.3.0

Big release with GPU support added for Linux and platform support for OpenBSD. Big thanks to @romner-set (GPU support) and @joske (OpenBSD support) for contributions. And a multitude of bugfixes and small changes, see CHANGELOG.md and latest release for detailed list and attributions.

See news entry below for more information regarding GPU support.

25 November 2023

GPU monitoring added for Linux!

Compile from git main to try it out.

Use keys 5, 6, 7 and 0 to show/hide the gpu monitoring boxes. 5 = Gpu 1, 6 = Gpu 2, etc.

Gpu stats/graphs can also be displayed in the "Cpu box" (not as verbose), see the cpu options menu for info and configuration.

Note that the binaries provided on the release page (when released) and the continuous builds will not have gpu support enabled.

Because the GPU support relies on loading of dynamic gpu libraries, gpu support will not work when also static linking.

See Compilation Linux for more info on how to compile with gpu monitoring support.

Many thanks to @romner-set who wrote the vast majority of the implementation for GPU support.

Big update with version bump to 1.3 coming soon.

28 August 2022

First release of btop4win available at https://github.com/aristocratos/btop4win

# Install and use Homebrew or MacPorts package managers for easy dependency installation
brew install coreutils make gcc@11 lowdown
git clone https://github.com/aristocratos/btop.git
cd btop
git checkout OSX
gmake

sudo pkg install gmake gcc11 coreutils git lowdown
git clone https://github.com/aristocratos/btop.git
cd btop
git checkout freebsd
gmake

Documents

CHANGELOG.md

CONTRIBUTING.md

CODE_OF_CONDUCT.md

Description

Resource monitor that shows usage and stats for processor, memory, disks, network and processes.

C++ version and continuation of bashtop and bpytop.

Features

• Easy to use, with a game inspired menu system.
• Full mouse support: all buttons with a highlighted key are clickable and mouse scrolling works in process list and menu boxes.
• Fast and responsive UI with UP, DOWN key process selection.
• Function for showing detailed stats for selected process.
• Ability to filter processes.
• Easy switching between sorting options.
• Tree view of processes.
• Send any signal to selected process.
• Pause the process list.
• UI menu for changing all config file options.
• Auto scaling graph for network usage.
• Shows IO activity and speeds for disks.
• Battery meter
• Selectable symbols for the graphs.
• Custom presets
• And more...

Themes

Btop++ uses the same theme files as bpytop and bashtop (some color values missing in bashtop themes).

See themes folder for available themes.

Btop searches the following directories for system themes:

• ../share/btop/themes (this path is relative to the btop executable)
• /usr/local/share/btop/themes
• /usr/share/btop/themes

The first directory that exists and isn't empty is used as the system themes directory.

The user themes directory depends on which environment variables are set:

• If $XDG_CONFIG_HOME is set, the user themes directory is $XDG_CONFIG_HOME/btop/themes
• Otherwise, if $HOME is set, the user themes directory is $HOME/.config/btop/themes
• Otherwise, the user themes directory is ~/.config/btop/themes

The make install