btm - A customizable cross-platform graphical process/system
monitor for the terminal. Supports Linux, macOS, and Windows.
btm [--autohide_time] [-b|--basic]
[--battery] [-S|--case_sensitive]
[-c|--celsius] [--color] [-C|--config]
[-u|--current_usage] [-t|--default_time_value]
[--default_widget_count] [--default_widget_type]
[--disable_advanced_kill] [--disable_click]
[-m|--dot_marker] [--enable_cache_memory]
[--enable_gpu_memory] [-e|--expanded]
[-f|--fahrenheit] [-g|--group]
[-a|--hide_avg_cpu] [--hide_table_gap]
[--hide_time] [-k|--kelvin]
[-l|--left_legend] [--mem_as_value]
[--network_use_binary_prefix] [--network_use_bytes]
[--network_use_log] [--process_command]
[-r|--rate] [-R|--regex] [--retention]
[--show_table_scroll_position] [-d|--time_delta]
[-T|--tree] [-n|--unnormalized_cpu]
[--use_old_network_legend] [-V|--version]
[-W|--whole_word] [-h|--help]
A customizable cross-platform graphical process/system monitor for
the terminal. Supports Linux, macOS, and Windows.
- --autohide_time
- Automatically hides the time scale in graphs after being shown for a brief
moment when zoomed in/out. If time is disabled via --hide_time then this
will have no effect.
- -b, --basic
- Hides graphs and uses a more basic look. Design is largely inspired by
htop's.
- --battery
- Shows the battery widget in default or basic mode. No effect on custom
layouts.
- -S,
--case_sensitive
- When searching for a process, enables case sensitivity by default.
- -c, --celsius
- Sets the temperature type to Celsius. This is the default option.
- --color=COLOR
SCHEME
- Use a pre-defined color scheme. Currently supported values are:
+------------------------------------------------------------+ | default |
+------------------------------------------------------------+ |
default-light (default but for use with light backgrounds) |
+------------------------------------------------------------+ | gruvbox
(a bright theme with 'retro groove' colors) |
+------------------------------------------------------------+ |
gruvbox-light (gruvbox but for use with light backgrounds) |
+------------------------------------------------------------+ | nord (an
arctic, north-bluish color palette) |
+------------------------------------------------------------+ |
nord-light (nord but for use with light backgrounds) |
+------------------------------------------------------------+ Defaults to
"default".
- -C, --config=CONFIG
PATH
- Sets the location of the config file. Expects a config file in the TOML
format. If it doesn't exist, one is created.
- -u,
--current_usage
- Sets process CPU% usage to be based on the current system CPU% usage
rather than total CPU usage.
- -t,
--default_time_value=TIME
- Default time value for graphs. Takes a number in milliseconds or a human
duration (e.g. 60s). The minimum time is 30s, and the default is 60s.
- --default_widget_count=INT
- Sets the n'th selected widget type to use as the default widget. Requires
'default_widget_type' to also be set, and defaults to 1.
This reads from left to right, top to bottom. For example,
suppose we have a layout that looks like:
+-------------------+-----------------------+ | CPU (1) | CPU (2) |
+---------+---------+-------------+---------+ | Process | CPU (3) |
Temperature | CPU (4) |
+---------+---------+-------------+---------+
And we set our default widget type to 'CPU'. If we set
'--default_widget_count 1', then it would use the CPU (1) as the default
widget. If we set '--default_widget_count 3', it would use CPU (3) as
the default instead.
- --default_widget_type=WIDGET
TYPE
- Sets which widget type to use as the default widget. For the default
layout, this defaults to the 'process' widget. For a custom layout, it
defaults to the first widget it sees.
For example, suppose we have a layout that looks like:
+-------------------+-----------------------+ | CPU (1) | CPU (2) |
+---------+---------+-------------+---------+ | Process | CPU (3) |
Temperature | CPU (4) |
+---------+---------+-------------+---------+
Setting '--default_widget_type Temp' will make the Temperature
widget selected by default.
Supported widget names: +--------------------------+ | cpu |
+--------------------------+ | mem, memory |
+--------------------------+ | net, network |
+--------------------------+ | proc, process, processes |
+--------------------------+ | temp, temperature |
+--------------------------+ | disk | +--------------------------+ |
batt, battery | +--------------------------+
- --disable_advanced_kill
- Hides advanced options to stop a process on Unix-like systems. The only
option shown is 15 (TERM).
- --disable_click
- Disables mouse clicks from interacting with the program.
- -m,
--dot_marker
- Uses a dot marker for graphs as opposed to the default braille
marker.
- --enable_cache_memory
- Enable collecting and displaying cache and buffer memory.
- --enable_gpu_memory
- Enable collecting and displaying GPU memory usage.
- -e,
--expanded
- Expand the default widget upon starting the app. Same as pressing
"e" inside the app. Use with "default_widget_type" and
"default_widget_count" to select desired expanded widget. This
flag has no effect in basic mode (--basic)
- -f,
--fahrenheit
- Sets the temperature type to Fahrenheit.
- -g, --group
- Groups processes with the same name by default.
- -a,
--hide_avg_cpu
- Hides the average CPU usage from being shown.
- --hide_table_gap
- Hides the spacing between table headers and entries.
- --hide_time
- Completely hides the time scale from being shown.
- -k, --kelvin
- Sets the temperature type to Kelvin.
- -l,
--left_legend
- Puts the CPU chart legend to the left side rather than the right
side.
- --mem_as_value
- Defaults to showing process memory usage by value. Otherwise, it defaults
to showing it by percentage.
- --network_use_binary_prefix
- Displays the network widget with binary prefixes (i.e. kibibits, mebibits)
rather than a decimal prefix (i.e. kilobits, megabits). Defaults to
decimal prefixes.
- --network_use_bytes
- Displays the network widget using bytes. Defaults to bits.
- --network_use_log
- Displays the network widget with a log scale. Defaults to a non-log
scale.
- --process_command
- Show processes as their commands by default in the process widget.
- -r,
--rate=TIME
- Sets the data refresh rate. Takes a number in milliseconds or a human
duration (e.g. 5s). The minimum is 250ms, and defaults to 1000ms. Smaller
values may take more computer resources.
- -R, --regex
- When searching for a process, enables regex by default.
- --retention=TIME
- How much data is stored at once in terms of time. Takes a number in
milliseconds or a human duration (e.g. 20m), with a minimum of 1 minute.
Note higher values will take up more memory. Defaults to 10 minutes.
- --show_table_scroll_position
- Shows the list scroll position tracker in the widget title for table
widgets.
- -d,
--time_delta=TIME
- The amount of time changed when zooming in/out. Takes a number in
milliseconds or a human duration (e.g. 30s). The minimum is 1s, and
defaults to 15s.
- -T, --tree
- Defaults to showing the process widget in tree mode.
- -n,
--unnormalized_cpu
- Shows all process CPU% usage without averaging over the number of CPU
cores in the system.
- --use_old_network_legend
- DEPRECATED - uses an older (pre-0.4), separate network widget legend. This
display is not tested anymore and could be broken.
- -V, --version
- Prints version information.
- -W,
--whole_word
- When searching for a process, return results that match the entire query
by default.
- -h, --help
- Print help (see a summary with '-h')
Clement Tsang <cjhtsang@uwaterloo.ca>