netshow 0.1.1

A real-time network connection monitor with friendly service names

🚦 NetShow

Friendly, process-aware network monitoring for your terminal

---

Table of Contents

• Features
• Quickstart
• Usage
• Keybindings
• Development
• Requirements
• Contributing
• License

---

✨ Features

Capability	Details
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

# Install (recommended)
uv pip install netshow

# Run
netshow

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

---

🛠️ Usage

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

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.