netshow 0.1.2

A real-time network connection monitor with friendly service names

netshow · interactive, process-aware network monitoring for your terminal

---

---

✨ Features

🔍 Live TCP monitor	Refreshes every 3 s (configurable) while preserving scroll position
👤 Human-friendly service names	Shows Docker, Plex, VS Code, etc. instead of cryptic binaries
🔬 Deep process drill-down	Path, PID, cmdline, cwd, threads, CPU %, memory %, open files, active connections
🖱️ Clickable / keyboard navigation	Press ↵ or click a row for a dedicated detail screen; refresh pauses automatically
🔐 Runs privileged or unprivileged	Uses psutil (root) for full fidelity, falls back to lsof if run as a regular user
🎨 Modern Textual UI	Smooth scrolling, dark theme, status bar with connection count & data source
⚡ Zero-pain install	Powered by uv for lightning-fast dependency resolution

---

🚀 Quickstart

# uvx (easiest)
uvx netshow

# Local Builds
git clone [e-mail]:taylorwilsdon/netshow.git
uv run netshow

💡 Tip: Without root/sudo, NetShow silently switches to lsof and still gives you most connections.

---

🛠️ Usage

netshow [--interval 1.0] [--no-colors]

Options

Option	Description	Default
--interval <sec>	Refresh rate (float)	3.0
--no-colors	Disable ANSI colors	Off

Keybindings

Key / Mouse	Action
↑ / ↓	Move cursor
↵ / Click	Open detail view
Esc / ←	Back to list
q	Quit NetShow

---

👩‍💻 Development

git clone https://github.com/taylorwilsdon/netshow.git
cd netshow
uv sync --extra dev

Quality Gates

pytest            # tests
ruff format .     # auto-format
ruff check .      # lint
mypy src/         # type check

---

📋 Requirements

• Python ≥ 3.9
• macOS or Linux
• lsof (usually pre-installed)

---

🤝 Contributing

Pull requests and ⭐ stars are welcome! Found a bug or have a feature request? Please open an issue.

---

📜 License

MIT – see LICENSE for full text.