btop - Man Page

• Start btop: btop
• Start btop with the specified settings preset: btop [-p|--preset] 0..9
• Start btop in TTY mode using 16 colors and TTY-friendly graph symbols: btop [-t|--tty]
• Start btop in 256-color mode instead of 24-bit color mode: btop [-l|--low-color]
• Set the update rate to 500 milliseconds: btop [-u|--update] 500
• Exit btop: <q>
• Display help: btop [-h|--help]

tldr.sh

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.

-c, --config file

Path to a config file.

-d,  --debug

Start in debug mode with additional logs and metrics.

-f, --filter filter

Set an initial process filter.

--force-utf

Force start even if no UTF-8 locale was detected.

-l,  --low-color

Disable true color, 256 colors only.

-p, --preset id

Start with a preset (0-9).

-t,  --tty

Force tty mode with ANSI graph symbols and 16 colors only.

--no-tty

Force disable tty mode.

--themes-dir dir

Path to a custom themes directory. When specified, this directory takes priority over the default theme search paths.

-u, --update ms

Set an initial update rate in milliseconds.

--default-config

Print default config to standard output.

-h,  --help

Show summary of options.

-V,  --version

Show version of program.

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

top(1), htop(1)

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