No description
Find a file
2026-06-15 10:01:31 +02:00
LICENSE initial commit 2026-06-15 10:01:31 +02:00
netwatch.py initial commit 2026-06-15 10:01:31 +02:00
README.md initial commit 2026-06-15 10:01:31 +02:00

netwatch — Network Bandwidth & Connection Monitor

Python TUI License

A terminal dashboard for watching live network throughput and active connections, written as a single-file Python 3 script using curses.

Features

  • Live per-interface download/upload rates with rolling sparkline graphs
  • Scrollable table of active TCP/UDP connections (IPv4 + IPv6), showing PID, process name, protocol, local/remote address, and connection state
  • Sort the connection table by PID, process, protocol, address, or state, ascending or descending
  • Live substring filter across process name, PID, addresses, and state
  • Adjustable refresh interval and pause/resume
  • Falls back to per-process queries (your own processes only) when not running as root, instead of failing outright

Requirements

  • Python 3.8+
  • psutil (pip install psutil)

Usage

chmod +x netwatch.py
./netwatch.py

Run with sudo to see connections belonging to all users' processes; without it, only your own processes are visible.

Key bindings

Key Action
/k, /j Move selection in the connection table
PgUp / PgDn Jump 10 rows
s Cycle sort column
S Reverse sort direction
/ Filter connections (Enter to apply, Esc to clear)
p Pause / resume live updates
+ / - Increase / decrease refresh rate
q Quit