bottom Graphical system monitor

Version 0.14.9 · source

Start here

btm
Start bottom
?
Open help
Ctrl+Right / L
Select widget on the right
/
Search processes
c
Sort by CPU
t
Process tree
d d
Kill process
q
Quit

Concepts

  1. Select widget Ctrl+arrows / H J K L
  2. Act inside it sort, search, scroll
  3. Expand e, Esc to return

Move around

Ctrl+Up / K
Select widget above
Ctrl+Down / J
Select widget below
Ctrl+Left / H
Select widget on the left
Ctrl+Right / L
Select widget on the right
Up / k
Move up in widget
Down / j
Move down in widget
g g / Home
Jump to first entry
G / End
Jump to last entry
PgUp / PgDn
Scroll a page
Ctrl+u / Ctrl+d
Scroll half a page

Display

e
Expand or shrink selected widget
Esc
Close dialog, search or expanded view
f
Freeze or unfreeze updates
Ctrl+r
Reset display and collected data
?
Open the help menu
q / Ctrl+c
Quit

Processes

c
Sort by CPU, again reverses
m
Sort by memory
p
Sort by PID
n
Sort by name
I
Invert current sort
s / F6
Open sort menu
t / F5
Toggle tree mode
Space
Collapse or expand tree branch
Tab
Group same-name processes
P
Full command or process name
%
Memory as value or percent
z
Hide kernel threads
d d / F9
Kill selected process, pick signal
M
Sort by GPU memory
C
Sort by GPU usage
/ / Ctrl+f
Open process search
Alt+c / F1
Toggle match case
Alt+w / F2
Toggle whole word
Alt+r / F3
Toggle regex
Ctrl+u
Clear the query
Ctrl+a / Ctrl+e
Cursor to start / end of query
Ctrl+w
Delete word behind cursor
Query keywords
Keyword Example Matches
pid pid=1044 Process ID
cpu cpu > 0.5 CPU percent
mem mem < 0.5 Memory percent
memb memb > 1000 b Memory in bytes
user user=root Owner
state state=running Process state
read / write read = 1 mb I/O per second
Query operators
Operator Meaning
= != > < >= <= Compare values
and && space Both conditions
or || Either condition
! Negate condition or group
( ) Group conditions
"cpu" Quote a word that is a keyword

Disk widget

d
Sort disks by name
u
Sort disks by used space
r
Sort disks by read rate
w
Sort disks by write rate

Command line

btm -b
Basic mode, no graphs
btm -e
Start with widget expanded
btm -T
Start in tree mode
btm -g
Group processes by default
btm -r <time>
Set refresh interval
btm -C <path>
Use a specific config file
btm -R
Regex search by default
btm -f
Temperatures in Fahrenheit
btm --read_only
Block killing processes
btm --battery
Show battery widget
btm --theme <scheme>
Pick a built-in theme
btm -h
Short option overview

Setup

Recipes

Heavy hitters by name
btm# select process widget, then:/name=chrome and mem > 1 gb
Safe look around
btm --read_only -b -r 2s
Per-user tree
btm -T# press / then:user=postgres
Dedicated config
btm -C ~/dotfiles/bottom.toml