btop - Man Page

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

Examples (TL;DR)

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.

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

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

--tty-off

Force disable tty mode.

-u, --update ms

Set an initial update rate in milliseconds.

-h,  --help

Show summary of options.

-V,  --version

Show version of program.

Bugs

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

See Also

top(1), htop(1)

Author

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

Info

2025-05-01