canido.dev
Projects/ClementTsang / bottom

bottom

A terminal system monitor with graphs, like top or htop

Get it on GitHub
Unclaimed

Built by @ClementTsang on GitHub. This page was written by @iluxav from public sources, last updated for 0.14.9 (2026-08-27), and may lag behind new releases.

Maintain bottom? Claim it
0.14.9 / 2026-08-279 things you can do4 changes to know before upgradingFollow (Atom feed)

Watch CPU, memory, network, disk, temperature, battery and GPU usage as graphs in the terminal, and sort, search and kill processes.

What you can do with it

Watch CPU (average and per core), RAM, swap and network usage as graphs over time, with zoom in and out.

Present at 0.11.1

Sort, search, filter and kill processes, and show them as a tree.

Present at 0.11.1

See disk capacity and usage, temperature sensors and battery status.

Present at 0.11.1

See GPU usage and GPU memory, including AMD GPUs on Linux and NVIDIA GPUs.

Good to know

AMD GPU data is Linux only. GPU features are on by default since 0.11.0; turn them off with `--disable_gpu`.

Present at 0.11.1

Change colours, themes, widget layout and behaviour with command-line options or a TOML config file.

Present at 0.11.1

Use an htop-like basic mode, or expand one widget to fill the screen.

Present at 0.11.1

Run bottom in a read-only mode where actions such as killing processes are disabled.

Since 0.12.3

Graph sensor temperatures over time.

Since 0.14.1

Graph disk read and write throughput over time.

Since 0.14.1

Before you upgrade

Newest first
0.14.12026-06-22

Options moved from `[flags]` into `[processes]`, `[cpu]`, `[memory_graph]` and `[network_graph]` (and `[network]` became `[network_graph]`); the old keys still work but print deprecation warnings, so move them to the new sections.

Behavior changedAffects: Config files that set process, CPU, memory or network options under `[flags]`
Read the evidence
Release history 8
0.14.92026-08-27

Start network totals at zero when bottom starts, to measure traffic from now on.

Details

New option to show total network usage zeroed at startup.

0.14.9.

Improved: Watch CPU (average and per core), RAM, swap and net…

Seeded by @iluxav with Claude Code (canido)

Read the evidence
0.14.72026-07-26

Set the default sort order of tables in the config file.

Details

New config option for the default sort order (ascending or descending). Groups 0.14.5 to 0.14.7, which also fix the first disk I/O reading at startup.

0.14.5 to 0.14.7.

Improved: Sort, search, filter and kill processes, and show t…

Seeded by @iluxav with Claude Code (canido)

Read the evidence
0.14.42026-07-09

Use the Memory, Memory%, Total Read and Total Write process columns in the config file as the schema documents.

Details

The config now accepts the `Memory`, `Memory%`, `Total Read` and `Total Write` column aliases, and uppercase Q quits as announced in 0.13.0.

0.14.4.

Now works: Change colours, themes, widget layout and behaviour…

Seeded by @iluxav with Claude Code (canido)

Read the evidence
0.14.12026-06-22

Graph temperatures and disk I/O over time, not just their current values.

Details

New temperature graph and disk I/O graph; packet rate and average packet size for networks; default sort columns for processes, disks and temperatures; `!=` and `!` in process search; search in the help dialog; table scroll bars. Config options moved from `[flags]` into per-widget sections, and CPU and memory use now respect cgroup limits. Groups 0.13.0, 0.14.0 and 0.14.1.

Also: Unmounted disks on Linux; FreeBSD UFS disk I/O; GPU short names; a `bg_colour` option; uppercase Q quits.

0.13.0 to 0.14.1. Building from source needs Rust 1.95 or newer.

Added: Graph sensor temperatures over time.Added: Graph disk read and write throughput over time.Improved: Watch CPU (average and per core), RAM, swap and net…Improved: Sort, search, filter and kill processes, and show t…Behavior changed: Watch CPU (average and per core), RAM, swap and net…Behavior changed: Change colours, themes, widget layout and behaviour…Action required / inferred: Change colours, themes, widget layout and behaviour…Action required

Seeded by @iluxav with Claude Code (canido)

Read the evidence
0.12.32025-12-31

Run bottom read-only, so processes cannot be killed by accident.

Details

Read-only mode disables killing processes; nice and priority columns in the process widget; spacebar toggles a process tree branch; Enter closes process search. Groups 0.12.0 to 0.12.3.

0.12.0 to 0.12.3.

Added: Run bottom in a read-only mode where actions such a…Improved: Sort, search, filter and kill processes, and show t…

Seeded by @iluxav with Claude Code (canido)

Read the evidence
0.11.32025-11-06

Count ZFS ARC as free memory so RAM usage is not overstated.

Details

New `free_arc` option subtracts the ZFS ARC from used memory.

0.11.3.

Improved: Watch CPU (average and per core), RAM, swap and net…

Seeded by @iluxav with Claude Code (canido)

Read the evidence
0.11.22025-10-07

See the threads of a process on Linux, and hide kernel threads.

Details

Threads are shown for processes on Linux; kernel threads can be hidden; a new option ignores all keypresses.

0.11.2.

Improved: Sort, search, filter and kill processes, and show t…

Seeded by @iluxav with Claude Code (canido)

Read the evidence
0.11.12025-08-14
Starting point

Watch CPU, memory and network usage as graphs in the terminal and manage processes in the same view.

Details

State as of 0.11.1: graph widgets for CPU, RAM/swap and network, table widgets for disks, temperatures, batteries and processes, configured by command-line options or a TOML config file.

Linux, macOS and Windows; packaged in many distros, on crates.io and as release binaries.

Added: Watch CPU (average and per core), RAM, swap and net…Added: Sort, search, filter and kill processes, and show t…Added: See disk capacity and usage, temperature sensors an…Added: See GPU usage and GPU memory, including AMD GPUs on…Added: Change colours, themes, widget layout and behaviour…Added: Use an htop-like basic mode, or expand one widget t…

Seeded by @iluxav with Claude Code (canido)

Read the evidence