btm

Show the default layout (CPU, memory, temperatures, disk, network, and processes)

$ btm

$ btm [[-b|--basic]]

$ btm [[-m|--dot_marker]]

$ btm --battery

$ btm [[-r|--rate]] 250 [[-t|--default_time_value]] 30000

btm [OPTIONS]

-b, --battery
    Display battery widget

--config <FILE>, -c <FILE>
    Path to config file (default: ~/.config/bottom/bottom.toml)

--cpu-utilization <MS>
    CPU utilization update rate in ms (default: 500)

-d, --debug
    Print debug information

--group <GROUP>
    Group processes by cgroup|process|user (default: process)

-h, --help
    Print help information

--hide_uts
    Hide uptime and load average widget

-i, --ipc
    Display IPC widget (default: true)

--list-modules
    List available modules

-n, --no-icons
    Disable icons

--num-cpus <N>
    Max CPUs to show (default: 10)

-p, --process <NAME|PID>
    Filter processes by name or PID

--rate <MS>
    Main update rate in ms (default: 1000)

--regex
    Use regex for process filter (default: false)

-V, --version
    Print version

-w, --whole-number
    Show whole numbers for CPU/mem (default: false)

btm (bottom) is a cross-platform, terminal UI for monitoring system resources and processes. It offers a modern alternative to top and htop, featuring real-time graphs for CPU, memory, network, disk I/O, temperature, and battery.

Navigate with mouse or keyboard: scroll processes, search with /, filter, kill processes, and toggle widgets. Processes display in tree or flat view, grouped by PID, user, or cgroup.

Customizable via ~/.config/bottom/bottom.toml: themes, layouts, colors, update rates. Supports icons (Nerd Fonts recommended) and whole-number stats. Low resource usage, written in Rust for speed and safety. Ideal for servers, desktops; updates dynamically without full redraws.

Widgets include CPU per-core bars/graphs, mem/swap pies, load averages, uptime. Filters by name/PID/regex. Debug mode for troubleshooting.

Requires terminal with mouse support for full features; icons need Nerd Fonts; high update rates increase CPU use.

q: quit | /: search | f: filter | k: kill | Enter: tree toggle | Mouse: scroll/click

User: ~/.config/bottom/bottom.toml | System: /etc/bottom/bottom.toml | Flags override config.

Developed by Clement Lavoie in 2020 as 'bottom'; rewritten in Rust for performance. Actively maintained on GitHub with v0.25+ adding features like cgroup grouping, better graphs.

top(1), htop(1), btop(1), glances(1)