ltop finds the process eating your bandwidth or disk — per process, per connection, per LAN peer — in one btop-style screen.
A terminal monitor for software and game developers, sysadmins and enthusiasts. Runs without root; an optional eBPF helper adds exact TCP and UDP byte accounting.
$ brew install uMaj35ty/ltop/ltop # macOS & Linux · prebuilt
$ cargo install ltop # from source · Rust stable
$ # or tarballs (x86_64/aarch64): github.com/uMaj35ty/ltop/releases
$ sudo cp ltop-bpf /usr/local/bin/ # from the same release
$ sudo cp ltop-bpf.service /etc/systemd/system/
$ sudo systemctl enable --now ltop-bpf
Six boxes, one job each. Everything on screen is also machine-readable —
ltop --json emits the same data as a versioned schema.
NET charts per-NIC throughput; DISK I/O plus a device tree with capacity bars; CONNS lists every socket with live per-connection B/s and totals; PROCS keeps per-process network (TCP+UDP) and disk totals for the whole session — exited processes stay on screen, grayed out, relaunchable with one key.
The kernel exposes no per-socket UDP counters, and sampling misses
short-lived connections. The optional root helper ltop-bpf
counts bytes at the send/recv syscalls (v4+v6), per pid and per socket
inode; the unprivileged TUI diffs a 1-second snapshot. Without the
helper, everything else keeps working.
ltop --json / --schema for one-shot questions;
ltop watch records a window headlessly and
ltop report --json returns exact sums and peaks — a
10-minute window costs ~1k tokens instead of ~40k. Agent skill included.
Passive ARP plus a periodic UDP knock finds devices on your subnet
(IP, MAC, mDNS hostname, gateway flag). Each neighbour shows its live
connection count, rate and bytes — enter pins it and filters
CONNS to that peer.
Any btop theme file loads as-is; 72 are built in and switchable at
runtime. On Omarchy ltop follows the desktop theme, and
--follow-theme re-colors it while running. UI in English or
Chinese (lang = zh).
x86_64 and aarch64; prebuilt for glibc 2.35+. The TUI runs unprivileged; macOS reads native sources (nettop, IOKit, route socket). Verified per release in QEMU/KVM on five distributions — SELinux enforcing included — and on Apple Silicon hardware.
From zero to full detail in three commands. The footer always shows the
current keys; m → help has the full table.
Prebuilt via Homebrew, source via cargo, or release tarballs — all channels.
$ brew install uMaj35ty/ltop/ltopOn macOS 27? Run ltop lan-setup once — real MAC
addresses in the LAN/NET boxes (per-user agent, no root).
Tab layouts · / search · enter detail panel · pcl focus a box · z zoom · 1–6 toggle boxes · space pause · m menu.
$ ltopLinux only; adds per-process/per-connection UDP and closes the short-lived-connection gap.
$ sudo systemctl enable --now ltop-bpfRecord a window headlessly, get exact per-process/per-connection sums and peaks as ~2 KB of JSON — ~97% fewer tokens than polling.
$ ltop watch --duration 10m --proc chrome $ ltop report <file> --json # ~1k tokens
What shipped, what's next. Details in the CHANGELOG.
--json/--schema, agent skillwatch + report — exact window summaries, ~97% fewer tokensltop lan-setup), streaming report, lossless-WebP docs, AtomGit mirrorltop mcp — a stdio JSON-RPC server wrapping the JSON surfaces for agents