netshow 0.3.0

Interactive, process-aware network monitoring for your terminal.

Python 3.11+ · macOS & Linux · Built with Textual

This checkout contains the UI refresh in development. Screenshots use example data. uvx netshow runs the published release; use the source instructions below to try this version.

Install and run

uvx netshow

For this development version:

git clone https://github.com/taylorwilsdon/netshow.git
cd netshow
uv sync --locked
uv run netshow

Or install the published package with pipx install netshow.

What it shows

• Live TCP connections with PID, friendly service name, process, endpoints, and status.
• Process details including executable, owner, command, working directory, threads, and live CPU/memory usage.
• Host or interface bandwidth: separate receive/transmit rates and a 30-second sparkline.
• Regex search across PID, names, addresses, and status; invalid patterns fall back to literal matching.
• Process/status sorting that preserves your selection, plus full IPv6 details.
• Confirmed process termination with a separate force-kill option if the process stays alive.
• The original Selenized Dark palette and labeled metric chips, built-in light/dark/ANSI themes, and a compact layout for small terminals.

Netshow tries psutil first and falls back to lsof when access is denied, as is common on macOS. Install lsof if your system doesn't include it. Without sufficient privileges, results may be incomplete; the status line marks limited visibility. Collection failures show an error and retain the last successful snapshot, marked stale.

Bandwidth is measured for the entire host or chosen interface. It is not per-process or per-connection throughput. Summing interfaces may count traffic at multiple layers on hosts with bridges, tunnels, or virtual interfaces.

Usage

netshow --interval 1.5
netshow --no-colors
netshow --version

Bandwidth samples every 0.5 seconds while the connection screen is visible. Connection collection pauses during details/dialogs and resumes immediately on return. Process details refresh every second while visible.

Clear the search text to remove the filter. Settings last for the current session. Single-letter shortcuts leave typing in the search field uninterrupted.

Terminate a process

Select a connection and press k, or use Terminate process… in its detail view. The dialog identifies the process and defaults to Cancel. Confirming Terminate sends SIGTERM and waits up to three seconds. If it remains alive, a second confirmation offers Force kill, which sends SIGKILL. Netshow never escalates automatically.

The action affects the whole process and all its connections, so unsaved work may be lost. Netshow rechecks PID and creation time before each signal, blocks unknown identities, PID 0/1, and itself, and reports permission failures or exited/replaced processes. It does not terminate process trees or request elevated privileges.

Development

uv sync --locked
uv run ruff format --check .
uv run ruff check .
uv run mypy src
uv run pytest -q
uv build

Run uv run ruff format . to format changes. CI tests Python 3.11–3.14 on Linux and Python 3.14 on macOS, and verifies installations from both wheel and source artifacts. Tests use synthetic connection data; process-control integration tests act only on children they start themselves.

See architecture and release instructions. The earlier published version remains available for Python 3.9/3.10 users.

License

MIT. Issues and contributions are welcome on GitHub.