aristocratos / btop

# 
## 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