manpage.md 1.7 KB
% btop(1) | User Commands % % 2025-05-01
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] [--themes-dir dir]
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.
--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.
-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.
SEE ALSO
top(1), htop(1)
AUTHOR
btop was written by Jakob P. Liljenberg a.k.a. "Aristocratos".