aristocratos/btop

Maintainer? Show your league in your README

Card: your league's emblem, from Copper to Legendary

[![bestofgithub](https://bestofgithub.dev/badge/aristocratos/btop.svg?style=card)](https://bestofgithub.dev/repo/aristocratos/btop)

Flat: fits beside your other badges

[![bestofgithub](https://bestofgithub.dev/badge/aristocratos/btop.svg)](https://bestofgithub.dev/repo/aristocratos/btop)

Loading README…

Flag	Description
`VERBOSE=true`	To display full compiler/linker commands
`STATIC=true`	For static compilation
`QUIET=true`	For less verbose output
`STRIP=true`	To force stripping of debug symbols (adds `-s` linker flag)
`DEBUG=true`	Sets OPTFLAGS to `-O0 -g` and enables more verbose debug logging
`ARCH=<architecture>`	To manually set the target architecture
`GPU_SUPPORT=<true\|false>`	Enable/disable GPU support (Enabled by default on X86_64 Linux)
`RSMI_STATIC=true`	To statically link the ROCm SMI library used for querying AMDGPU
`ADDFLAGS=<flags>`	For appending flags to both compiler and linker
`CXX=<compiler>`	Manually set which compiler to use

Configure flag	Description
`-DBTOP_STATIC=<ON\|OFF>`	Enables static linking (OFF by default)
`-DBTOP_LTO=<ON\|OFF>`	Enables link time optimization (ON by default)
`-DBTOP_GPU=<ON\|OFF>`	Enable GPU support (ON by default)
`-DBTOP_RSMI_STATIC=<ON\|OFF>`	Build and link the ROCm SMI library statically (OFF by default)
`-DCMAKE_INSTALL_PREFIX=<path>`	The installation prefix ('/usr/local' by default)

Flag	Description
`VERBOSE=true`	To display full compiler/linker commands
`STATIC=true`	For static compilation (only libgcc and libstdc++)
`QUIET=true`	For less verbose output
`STRIP=true`	To force stripping of debug symbols (adds `-s` linker flag)
`DEBUG=true`	Sets OPTFLAGS to `-O0 -g` and enables more verbose debug logging
`GPU_SUPPORT=<true\|false>`	Enable/disable GPU support (Enabled by default on macOS)
`ARCH=<architecture>`	To manually set the target architecture
`ADDFLAGS=<flags>`	For appending flags to both compiler and linker
`CXX=<compiler>`	Manually set which compiler to use

Configure flag	Description
`-DBTOP_LTO=<ON\|OFF>`	Enables link time optimization (ON by default)
`-DBTOP_GPU=<ON\|OFF>`	Enable GPU support (ON by default)
`-DCMAKE_INSTALL_PREFIX=<path>`	The installation prefix ('/usr/local' by default)

Flag	Description
`VERBOSE=true`	To display full compiler/linker commands
`STATIC=true`	For static compilation (only libgcc and libstdc++)
`QUIET=true`	For less verbose output
`STRIP=true`	To force stripping of debug symbols (adds `-s` linker flag)
`DEBUG=true`	Sets OPTFLAGS to `-O0 -g` and enables more verbose debug logging
`ARCH=<architecture>`	To manually set the target architecture
`ADDFLAGS=<flags>`	For appending flags to both compiler and linker
`CXX=<compiler>`	Manually set which compiler to use

Index

News

22 March 2026

4 December 2025

22 September 2024

7 January 2024

25 November 2023

28 August 2022

16 January 2022

13 November 2021

30 October 2021

6 October 2021

18 September 2021

5 May 2021

Documents

Description

Features

Themes

Support and funding

Prerequisites

Optional Dependencies (Needed for GPU monitoring)

Notice (Text rendering issues)

Screenshots

Main UI showing details for a selected process

Main UI in TTY mode

Main UI with custom options

Main-menu

Options-menu

Help-menu

Installation

Compilation Linux

GPU compatibility

With Make

With CMake (Community maintained)

Compilation macOS OSX

With Make

With CMake (Community maintained)

Compilation FreeBSD

With gmake

With CMake (Community maintained)

Compilation NetBSD

With gmake

With CMake (Community maintained)

Compilation OpenBSD

With gmake

With CMake (Community maintained)

Testing

Installing the snap

Note: there are now two snaps available: btop and btop-desktop. The desktop version is much larger and includes the desktop entries needed to allow for launching btop with a click.

Configurability

btop.conf: (auto generated if not found)

Command line options

LICENSE

Note: there are now two snaps available: `btop` and `btop-desktop`. The desktop version is much larger and includes the desktop entries needed to allow for launching `btop` with a click.