ltop/localist top
A terminal monitor for a single machine: where network traffic goes (who talks to whom), what the processes are doing (who eats bandwidth and disk), and what the LAN looks like — the main program runs without root, and an optional eBPF helper adds per-process and per-connection byte accounting.
Quick install
AUR: ltop-bin — coming as soon as the AUR reopens registration (package is ready).
Screenshots
Classic layout on Omarchy, with the desktop theme followed:

Wide layout with the detail panel (captured command line, per-connection breakdown, track / kill / relaunch) and the theme menu:

Tall layout — grouped connections with totals and a tracked row highlighted:

Live Omarchy theme following (--follow-theme) — the palette re-colors while
ltop runs as the desktop theme switches:

Features
- Six boxes, one job each
- NET — per-NIC real-time throughput (braille area charts), link state/speed/duplex/MTU/IP, cumulative traffic since startup
- LAN — automatic same-subnet device discovery: IP / MAC / hostname / interface, gateways marked, background scanning; each neighbour shows the live connection count, rate and accumulated bytes to it (linked with CONNS)
- DISK I/O / DISKS — read/write rate charts (deduplicated per device) plus
a physical device tree (
nvme0n1 → dm-0(root)), capacity bars and live rates - CONNS — every connection on the system: TCP shows true per-connection B/s and totals; UDP connections are eBPF-metered and get the same columns; protocol tags, process grouping, 5-second tombstone rows for closed connections, four-state filter (all / lan / tcp / udp)
- PROCS — per-process total network (TCP+UDP — short-lived connections are never missed) and total disk I/O for the session; exited processes stay grayed out with their captured command line and can be relaunched with one key; search, pinned tracking, four sort modes
- eBPF accounting (TCP+UDP, optional) — netlink offers no per-socket byte
counters for UDP, and per-socket TCP sampling loses connections that live for
less than one sampling tick; a privileged helper
ltop-bpfattaches kprobes to the send/recv syscalls (v4+v6), accumulates bytes per pid and per socket inode, and writes a snapshot to/run/ltop/udp.jsonevery second. The unprivileged UI diffs the snapshots and merges them into its ledgers. No nightly toolchain needed — the eBPF object is built with the system clang at compile time. Without the helper the feature is silently absent; everything else keeps working - Monitoring log & replay —
Lrecords per-process ledgers to JSONL (60 s granularity by default, retention configurable);--replayrebuilds session deltas into a report,--csvexports it - Three layouts —
Tabcycles classic (charts left, tables right with the CONNS bottom edge aligned to the chart split) / wide / tall; boxes toggled with1–6collapse automatically - Themes & language — 41 embedded btop themes switchable at runtime, or
follow the Omarchy desktop theme (picked up at startup; add
--follow-themeto also re-color a running ltop when the desktop theme changes — off by default); UI in English or Chinese - Focus & tracking —
p/c/lsingle-focus procs/conns/lan, arrow-key selection that follows the process/connection/neighbour across re-sorts, detail panel with tracking pin, kill and relaunch;enteron a lan row pins the neighbour and filters CONNS to that peer
Requirements & Building from source
Rust stable and Linux, x86_64 / aarch64 — the eBPF probes carry per-arch
pt_regs register mappings for both, and binaries refuse to start elsewhere.
The eBPF accounting additionally needs a clang with the bpf target (Arch's
clang works) and root to deploy the helper.
Tested environments
Release tarballs verified per distribution in QEMU/KVM (open-box binaries, eBPF probe attach incl. kprobe, systemd unit, silent degrade without the helper). ltop is developed daily on Omarchy (Arch), which doubles as the reference desktop environment.
| Environment | Kernel | eBPF accounting | Notes |
|---|---|---|---|
| Arch Linux (rolling) | 7.2.7 | ✓ full | also the dev machine (Omarchy desktop) |
| Ubuntu 24.04 LTS | 6.8 | ✓ full | glibc 2.39 |
| Ubuntu 22.04 LTS | 5.15 | ✓ full | works without BTF; glibc 2.35 is the binary baseline |
| Ubuntu 24.04 LTS (aarch64) | 6.8 | ✓ full | QEMU aarch64 emulation; Raspberry-Pi-class hardware expected to match |
| Debian 13 | 6.12 | ✓ full | glibc 2.41 |
| Fedora 44 (Workstation live) | 6.19 | ✓ full | SELinux enforcing: zero denials |
Older kernels trim kprobes/BTF in specialty flavours (e.g. Ubuntu's -kvm
cloud kernel): use the generic kernel there — not an ltop limitation.
# or build from source:
Binaries: ltop and ltop-bpf (privileged collector). Release tarballs and the
AUR package ship a loli symlink as an out-of-the-box alias (-h follows the
invoked name); cargo install users can add it with ln -s ltop loli.
~/.config/ltop/config.conf is plain key = value, written by the
in-app settings panel and safe to hand-edit (applies on restart): refresh
tick_ms, log interval/retention, sweep interval, box toggles, sort defaults,
tombstone TTL tombstone_ttl_ms, theme, lang and more.
Smoke test & diagnostics
Key bindings
| Key | Action |
|---|---|
q / Ctrl-C |
quit |
space |
pause/resume sampling (frame freezes; bytes are back-filled on resume) |
/ |
search: substring-filter processes/connections by name (Tab switches the target box, enter applies, esc clears) |
m |
btop-style menu (themes / settings / reset / graphs / help / quit / close) |
Esc |
clear focus & selection on the main screen; closes panels |
1–6 |
toggle boxes: 1 net, 2 lan, 3 disk i/o, 4 disks, 5 conns, 6 procs |
Tab |
layout classic → wide → tall |
p / c / l |
single-focus procs / conns / lan (lighting one extinguishes the others) |
r |
procs sort: name → net-sum → net-rate → disk-sum → disk-rate |
f / o |
conns filter all → lan → tcp → udp / sort proc (same-name processes grouped by total traffic; group head shows ▸/▾name ×N, group Σ, row tinted by expand state) → sum → name → rate |
enter / ← → on a group head |
collapse / expand that process group (search hits auto-expand; clicking a group head toggles too; default state configurable in settings) |
d |
expand/collapse the disk mount tree |
e |
lan sort: ip → hostname → mac → iface |
n / i |
switch NIC / disk i/o chart mode |
↑↓ / PgUp PgDn / wheel |
move selection / scroll lists; the wheel scrolls the list under the cursor, clicking a row selects it (btop-style, no visible scrollbar) |
enter on a lan row |
pin the neighbour to the top (red highlight) and filter CONNS to that peer; enter again unpins and clears; esc/f also clear |
enter on a conns/procs row |
detail panel: processes show exited state, captured command line, UDP breakdown and uptime; connections show protocol, owner, lifetime, totals and rates; space/t pin (tracked rows stay on top), k kill, s relaunch |
k |
SIGTERM the selected process (needs "global kill" enabled in settings) |
L |
start/stop the monitoring log |
s |
LAN sweep on/off |
+ / - |
refresh interval ±250 ms |
Closed connections remain as grayed tombstone rows for 5 s (values frozen at their last state; the tombstone TTL is configurable in settings).
Data scopes (a mismatch is not a bug)
- PROCS = application payload bytes (eBPF, session-accumulated); the NET box = NIC bytes (includes IP/TCP headers, retransmits, kernel traffic) — a 10–40 % gap between the two is expected
- CONNS: TCP Σ counts since the connection was established (kernel semantics, including before ltop started); UDP Σ is session-accumulated
- Traffic through a proxy is attributed to the proxy process
How it works
- eBPF pipeline: kprobes on the send/recv syscalls accumulate bytes per pid and per socket inode (the inode is resolved in-kernel via a CO-RE walk of sk→socket→file→inode), snapshot atomically every second, then diffed and merged by the unprivileged UI. Guard rails: a 16 MiB value gate on register reads, a flock single-instance lock, and snapshot instance IDs so the UI re-baselines instead of diffing across collector restarts. Detaching is automatic on exit — a crashed collector never leaves probes behind
- LAN discovery: passive
/proc/net/arpreads plus a discard-port UDP knock every 60 s (the kernel does the ARP, no application traffic); hostnames via a three-step best-effort chain: mDNS reverse lookup → NetBIOS node status → reverse DNS - Data sources: netlink
inet_diag(connection table, TCP counters),/proc/net/dev,/proc/diskstats+statvfs,/proc/net/arp— see the header comments insrc/collect/for details
Limitations
- Connections of other users can only be attributed to the uid level
(
/proc/<pid>/fdis unreadable for them) - WiFi NICs expose no link
speedfrom the kernel; the field stays empty - CONNS TCP totals include the connection's whole history (kernel semantics), which differs from PROCS session totals by design
- After an
ltop-bpfrestart the eBPF counters start from zero (the UI re-baselines automatically via snapshot instance IDs)
Development
Diagnostics live in scripts/ (udp-smoke.sh, snap-diff.py); the eBPF
program is bpf/net_bpf.c; collectors are under src/collect/; the privileged
daemon is src/bin/ltop_bpf.rs; the systemd unit is in deploy/.
Themes are ported from btop (Apache-2.0); all other code and docs are released under the MIT license (see LICENSE).