rigtop

Early development. The TUI and GUI work on Linux and Windows and monitor several hosts over SSH with an overview.

A btop-inspired system monitor with two front-ends that share one data-collection core:

• rigtop — terminal UI
• rigtop-gui — native GUI (no web view) with a btop-like layout and resizable panels

日本語版 README

Goals

• The btop overview on one screen: CPU (total, per core, temperatures), every GPU, memory, storage, network, and a process list with kill / force kill.
• Storage health, which existing monitors mostly skip: btrfs RAID profiles and per-device error counters, mdadm array state, NVMe temperatures, and SMART health.
• Per-process GPU usage and VRAM (NVIDIA, via NVML).
• Combined CPU + GPU power draw and fan speeds (with your own labels for fan channels).
• Multiple hosts over plain SSH: rigtop --agent streams snapshots over stdin/stdout, so there is no daemon to run and no port to open.

Roadmap

1. Collection core and the TUI on Linux (v0.1)
2. Native GUI on Linux (v0.1)
3. Windows support (v0.1; temperatures, fans and CPU power still missing; macOS builds without hardware testing)
4. Remote monitoring over SSH: one host (v0.2), several hosts with an overview (v0.3)

Installation

Download an archive for your platform from the Releases page and put the binaries on your PATH:

SHA256SUMS lists the checksums. With a Rust toolchain (1.95 or newer) you can also install from crates.io:

cargo install rigtop rigtop-gui

Usage

cargo run --release -p rigtop            # terminal UI
cargo run --release -p rigtop -- --help  # options (--interval-ms, --config, --dump-json)

GUI

cargo run --release -p rigtop-gui            # same options: --interval-ms, --config

Drag panel borders to resize and panel titles to rearrange. Click a column header to sort, right-click a process to terminate or kill it (asks first), and pick the network interface from the list.

Zoom with Ctrl + mouse wheel, Ctrl + + / - / 0, or the A- / A+ buttons in the CPU panel title. The zoom level and panel layout are restored on the next start; "reset layout" brings back the default arrangement.

With mouse support on, most terminals select text with Shift+drag.

Remote monitoring over SSH

Install rigtop on the remote hosts too, then list them in the configuration file or on the command line:

# ~/.config/rigtop/config.toml
[[hosts]]
name = "zefat"                 # also the ssh destination unless `ssh` is given

[[hosts]]
name = "nas"
ssh = "admin@nas.local"
command = "/usr/local/bin/rigtop --agent"
sections = ["storage", "cpu", "network"]   # what this host's overview card shows first

rigtop                          # TUI: hosts from the configuration
rigtop-gui --host hermon        # GUI: plus a host from the command line (repeatable)

In the GUI, hosts… (in the tab bar, or in the CPU panel title while only this machine is shown) adds, edits and removes hosts and can test the connection first. Changes are written to the [[hosts]] of the configuration file, so the TUI sees them too; the rest of the file is left as it is.

With more than one host, rigtop opens on an overview with one card per host, plus a tab per host (this machine included) for the full detail view. Cards show alerts (storage errors, failing SMART, degraded RAID, nearly full filesystems, hot GPUs) and then CPU, GPU, memory, the top processes, network and storage, in that order and as far as the card has room. Change the default order with [overview] sections, per host with sections, or in the GUI with each card's "sections" menu. Whether this machine gets a card is [overview] include_local (or the checkbox in the GUI, l in the TUI). In the TUI, Tab and 0-9 switch between the overview and the hosts.

rigtop starts rigtop --agent on each remote host through your system's ssh (the built-in OpenSSH client on Windows), so ~/.ssh/config, keys and ProxyJump work as usual. There is no daemon to run and no port to open; the agent exits when the connection closes, and rigtop reconnects by itself. Hosts not shown in detail only send their top processes.

• Authentication must work without a prompt (key or agent), and the host key must already be known: connect once with ssh <host> first.
• If rigtop is not on the PATH of non-interactive SSH sessions, set command for the host (or --remote-command for --host), e.g. ~/.cargo/bin/rigtop --agent.
• Killing processes on a remote host uses the SSH user's permissions.

Windows

Both rigtop and rigtop-gui run on Windows (see Installation). Builds of the latest main are also attached to the CI runs (artifact rigtop-windows-x86_64).

What differs from Linux:

• CPU load, memory, processes, network (with link speeds), drive capacity and per-drive I/O, and NVIDIA GPUs (via nvml.dll from the driver) work without extra software.
• Temperatures, fans and CPU power need hardware drivers that Windows does not ship; only what Windows itself reports is shown, which is often nothing. (Reading them through LibreHardwareMonitor is planned.)
• There is no load average and no disk busy percentage.
• Windows has no signals: "kill" (K) ends the process immediately; "terminate" (k) asks the process's windows to close, like Task Manager's "End task", and reports when the process has no window (console programs, services).

SMART and btrfs scrub results (optional)

SMART data and btrfs scrub results are readable only by root, and rigtop never runs as root or loosens device permissions. Instead, a root systemd timer collects them every 10 minutes into world-readable files under /var/lib/rigtop/, and rigtop reads those:

• smart/<device>.json: smartctl -j -a for every drive (sleeping disks are not woken up)
• btrfs/scrub.status.<fsid>: copies of btrfs-progs' scrub status, shown as when data was last verified

sudo apt install smartmontools   # or your distribution's package
sudo install -m 755 contrib/collect/rigtop-collect /usr/local/libexec/
sudo install -m 644 contrib/collect/rigtop-collect.service contrib/collect/rigtop-collect.timer /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now rigtop-collect.timer

The SMART files include drive serial numbers.

Configuration

~/.config/rigtop/config.toml (%APPDATA%\rigtop\config.toml on Windows). Every setting is optional.

[sensors]
# Names for sensor channels, keyed by the channel key rigtop shows.
labels = { "nct6686:nct6683.2592/fan1" = "CPU fan" }
# Channels to hide, e.g. unconnected thermistors reading -40 °C.
hidden = ["nct6686:nct6683.2592/temp4"]

[smart]
dir = "/var/lib/rigtop/smart"

[btrfs]
scrub_dir = "/var/lib/rigtop/btrfs"

License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.