README

!btop++


    


!Linux
!macOS
!FreeBSD
!NetBSD
!OpenBSD
!Usage
!c++23
!latest_release







 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 th

Top issues

Discussions

Latest release

Changelog v1.4.8

References | Description | Author(s)
--- | --- | ---
1390 | themes: load/save by name if possible | @katexochen
1649 | Fix atomic issues and data races in btop | @ItsMeSamey
1641 | fix: gate Apple Silicon GPU support to unbreak intel Mac builds | @NLagwal
1661 | AMD APU/iGPU sysfs backend for GPU monitoring | @mgajda
1663 | fix: use ISO 8601 format for log timestamps | @jsquyres
1662 | Fix possible thread deadlocks and power-event-based false stall detections | @jsquyres
1674 | fix: defer SIGWINCH resize handling | @jsquyres
1652 | Fix btop with amd gpu on rocm 7 as in Ubuntu