btop(1) User Commands btop(1)

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

btop [-c file] [-d] [-f filter] [-l] [-p id] [-t] [-u ms] [--force-utf] [--themes-dir dir]

btop [--default-config | {-h | --help} | {-V | --version}]

btop is a program that shows usage and stats for processor, memory, disks, network, and processes.

The program follows the usual GNU command line syntax, with long options starting with two dashes (‘-’). A summary of options is included below.

Path to a config file.
Start in debug mode with additional logs and metrics.
Set an initial process filter.
Force start even if no UTF-8 locale was detected.
Disable true color, 256 colors only.
Start with a preset (0-9).
Force tty mode with ANSI graph symbols and 16 colors only.
Force disable tty mode.
Path to a custom themes directory. When specified, this directory takes priority over the default theme search paths.
Set an initial update rate in milliseconds.
Print default config to standard output.
Show summary of options.
Show version of program.

The upstream bug tracker can be found at https://github.com/aristocratos/btop/issues.

top(1), htop(1)

btop was written by Jakob P. Liljenberg a.k.a. “Aristocratos”.

2025-05-01