pview 1.0.0

Beautiful Port Inspector TUI — see who's using your ports

pview

Beautiful Port Inspector TUI — see who's using your ports

---

A gorgeous, fast alternative to lsof -i and netstat. See which processes are listening on which ports — with CPU/memory usage, one-key kill, live refresh, and beautiful terminal output.

Why?

• lsof -i output is ugly and hard to parse
• Developers constantly debug port conflicts
• No existing tool combines port listing + process info + kill in a single TUI
• "What's on port 3000?" is one of the most-asked developer questions

Features

Feature	Description
Interactive TUI	Full Textual app with table, filter, detail panel, kill dialog
Port Listing	All listening TCP/UDP ports with process info
Process Details	PID, name, command, user, CPU%, memory
One-Key Kill	Select process → press k → confirm → done
Filter/Search	Filter by port number or process name
Watch Mode	Live-updating view with configurable interval
Port Check	Quick check: pview check 3000
JSON/CSV Export	Machine-readable output for scripting
Safety Guards	Refuses to kill system-critical processes

Install

pip install pview

Requires Python 3.10+. Works on macOS and Linux.

Usage

Interactive TUI (default)

pview

Non-interactive listing

# Rich table output
pview list

# JSON output
pview list --format json

# CSV output
pview list --format csv

# Filter by process name
pview list --filter postgres

# Watch mode (live refresh)
pview list --watch

# TCP only
pview list --no-udp

Check a specific port

pview check 3000
# → Port 3000: node (PID 12345) — node server.js

pview check 9999
# → ✅ Port 9999 is free.

Kill a process by port

pview kill 3000
# → Kill node (PID 12345) on port 3000? [y/N]

# Skip confirmation
pview kill 3000 --yes

# Force kill (SIGKILL)
pview kill 3000 --force --yes

TUI Keybindings

Key	Action
/	Focus filter input
Escape	Clear filter
k	Kill selected process
d	Toggle detail panel
r	Refresh data
q	Quit

TUI Preview

╭─ pview ──────────────────────────────────────────────────╮
│ Filter: [________]                                           │
├──────┬──────────┬───────┬──────────┬──────┬─────────┬───────┤
│ Port │ Process  │  PID  │   User   │ CPU% │ Memory  │Status │
├──────┼──────────┼───────┼──────────┼──────┼─────────┼───────┤
│   80 │ nginx    │  1234 │ www      │  0.2 │ 12.3 MB │LISTEN │
│  443 │ nginx    │  1234 │ www      │  0.2 │ 12.3 MB │LISTEN │
│ 3000 │ node     │  5678 │ dev      │  1.5 │ 85.2 MB │LISTEN │
│ 5432 │ postgres │  9012 │ postgres │  0.8 │156.7 MB │LISTEN │
│ 8080 │ java     │  7890 │ dev      │  3.2 │512.0 MB │LISTEN │
├──────┴──────────┴───────┴──────────┴──────┴─────────┴───────┤
│ [k] Kill  [d] Details  [r] Refresh  [/] Filter  [q] Quit    │
╰─────────────────────────────────────────────────────────────╯

Development

git clone https://github.com/bhayanak/pview.git
cd pview
pip install -e ".[dev]"

# Run tests
pytest --cov=pview --cov-report=term-missing

# Lint & format
ruff check src/ tests/
ruff format --check src/ tests/

See CONTRIBUTING for more details.

License

MIT — use it, fork it, improve it.