bottom
Cross-platform graphical system and process monitor
TLDR
SYNOPSIS
btm [options]
DESCRIPTION
bottom (binary name btm) is a cross-platform graphical system monitor for the terminal. It displays real-time information about CPU usage, memory consumption, disk I/O, network traffic, temperatures, and running processes with interactive charts and graphs.
The interface supports mouse and keyboard navigation, process searching and filtering, process signal sending, and multiple layout configurations. It provides both graphical chart mode and a simpler basic text mode for environments where Unicode support is limited.
bottom is written in Rust and designed as a modern alternative to tools like top and htop, with a focus on visual presentation and cross-platform support across Linux, macOS, and Windows.
PARAMETERS
-b, --basic
Use basic mode without charts.-C, --celsius
Use Celsius for temperature.-F, --fahrenheit
Use Fahrenheit for temperature.-g, --group
Group processes with the same name.-r MS, --rate MS
Set refresh rate in milliseconds (default: 1000).-t, --tree
Show processes as a tree.--default_widget_type TYPE
Set the default widget to focus on startup.-C FILE, --config FILE
Use a custom configuration file.--color SCHEME
Use a color scheme (default, gruvbox, nord, etc.).--mem_as_value
Show memory usage as values rather than percentages.--battery
Show battery widget.-h, --help
Show help information.-V, --version
Show version.
CONFIGURATION
Configuration is stored in ~/.config/bottom/bottom.toml. Options include custom color themes, widget layouts, default behaviors, temperature units, and disk/network filters. All command-line flags can be set as defaults in the config file.
CAVEATS
The binary name is btm, not bottom. Some features like temperature sensors and battery monitoring may not be available on all platforms. High refresh rates can increase CPU usage.
HISTORY
bottom was created by Clement Tsang and first released in 2019. Written in Rust, it was designed to provide a visually appealing and highly customizable alternative to traditional system monitors, inspired by tools like gtop and gotop.

