Scroll to navigation

btop(1) User Commands btop(1)

NAME

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

SYNOPSIS

btop [-c] [-d] [-l] [-t] [-p id] [-u ms] [--force-utf]

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

DESCRIPTION

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

OPTIONS

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.
Set an initial update rate in milliseconds.
Show summary of options.
Show version of program.

BUGS

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

SEE ALSO

top(1), htop(1)

AUTHOR

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

2025-05-01