1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
|
% 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** _file_] [**-d**] [**-f** _filter_] [**-l**] [**-p** _id_] [**-t**] [**-u** _ms_] [**\-\-force-utf**] [**\-\-themes-dir** _dir_]
**btop** [**\-\-default-config** | {**-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**
: 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.
# 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".
|
