netop 0.1.1

轻量级 Linux 终端网络流量监控工具

---

netop

中文说明

netop is a focused rewrite of the original tmd-top idea for day-to-day Linux network troubleshooting. The upstream project has not seen active feature work for a while, and its original design bundled GeoIP lookup, SQLite snapshot tables, firewall mutation, and TUI rendering into one application. This fork intentionally narrows the scope to one job: fast, read-only terminal network monitoring.

Design Goals

• Pure monitoring: no IP ban button, no iptables, nftables, or firewalld writes.
• Stateless runtime: no SQLite database and no persistent traffic history.
• No GeoIP: no bundled MMDB file, no location column, no per-IP lookup cost.
• Low overhead: collect from ss, ps, and /proc/net/dev, then calculate rates from in-memory deltas.
• Modern Textual path: use public Textual APIs and track textual>=8.2,<9 instead of pinning to textual==1.0.0.

Current Status

This is an early refactor branch. The package and CLI entry point have been renamed to netop. Compatibility with the old tmd and tmd-top command names is intentionally not preserved.

The UI currently shows:

• interface traffic
• listening services
• outbound processes
• per-service or per-process TCP connection details
• search, refresh mode, sort mode, permission state, and rate unit state

Requirements

• Python >= 3.10
• Linux
• iproute2 for ss
• procps for ps

Install

The recommended installation path is PyPI:

python -m pip install netop

If your default pip index is an internal mirror that has not synced netop yet, install from the official PyPI index:

python -m pip install --index-url https://pypi.org/simple netop

For local development, install from source:

python -m pip install -e .

Usage

If netop was installed in a user environment, run it directly:

netop

In normal-user mode, netop will still try sudo -n ss when passwordless sudo is available, so it can display more PID/process ownership data without prompting for a password inside the TUI.

If netop is installed in a root-visible environment, or you need the most complete socket ownership data, run:

sudo netop

Shortcuts

Key	Action
q	Quit
v	Focus search
b	Toggle bit/byte rate mode
t	Slow refresh to 5 seconds
y	Restore refresh to 1 second
r	Sort by total traffic
c	Sort by connections
i	Sort by unique IP count
u	Sort by upload
d	Sort by download
z	Sort by CPU
x	Sort by memory

Click or highlight a listening service or outbound process row to display its connection details on the right.

Display Units

By default, netop displays network rates as bit rates such as Kb/s and Mb/s. Press b to switch to byte-rate mode such as KB/s and MB/s.

Data Flow

1. ss -tniH state established reads TCP socket counters.
2. ss -tpanH reads listening sockets, established sockets, PIDs, and process names when available.
3. ps provides lightweight CPU and memory metadata by PID.
4. /proc/net/dev provides interface-level counters.
5. The collector computes deltas in memory and sends immutable snapshots to the Textual UI.

What Changed From tmd-top

Area	netop direction
GeoIP	Removed
SQLite	Removed
Firewall ban actions	Removed
Package name	netop
CLI command	netop only
Textual dependency	textual>=8.2,<9
Runtime model	Read-only, in-memory snapshots

Original Project

Original repository README: https://github.com/CDWEN0526/tmd-top