PORTWATCH
A tactical port scanner dashboard for developers. See what's running on your machine at a glance.
╔═══════════════════════════════════════╗
║ ▓▓▓ P O R T W A T C H ▓▓▓ v0.1.0 ║
╚═══════════════════════════════════════╝
Installation
cd portwatch
pip install -e .
Or run directly:
pip install textual psutil rich
python -m portwatch
Usage
portwatch
Keybindings
| Key | Action |
|---|---|
↑↓ |
Navigate ports |
Enter |
Open action menu |
b |
Open in browser |
k |
Kill process |
c |
Copy port |
r |
Manual refresh |
1/2/5 |
Set refresh rate |
q |
Quit |
Features
- Live auto-refresh (configurable 1s/2s/5s)
- Category grouping (Web, Database, Queue, DevTools, System)
- Process details (PID, memory, uptime, cmdline)
- Quick actions (browser, kill, copy)
- Docker container detection
- Tactical military aesthetic
Requirements
- Python 3.10+
- macOS / Linux (Windows partial support)
Metadata
Release files for portwatch-tui 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| portwatch_tui-0.1.0.tar.gz | 15.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| portwatch_tui-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 33.7 kB
Release files / portwatch_tui-0.1.0.tar.gz
| Download URL | portwatch_tui-0.1.0.tar.gz |
|---|---|
| Size | 15.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d84c867742a09a3e407d21deffdb7fd098feb7ff33c4d6c057e18c5cad050963
|
|
BLAKE2b-256 checksum How to use checksums |
32b83ebf7b1829b47e0ceb190bb0f3ddfdcd880cee628c9fe53258b96eca46a7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.0
|
Release files / portwatch_tui-0.1.0-py3-none-any.whl
| Download URL | portwatch_tui-0.1.0-py3-none-any.whl |
|---|---|
| Size | 18.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
1db1e6cea46770b5587e72e443b74dffc97d6c008be1f569a93335ca11a167e3
|
|
BLAKE2b-256 checksum How to use checksums |
932fa3dcd17c5025e964d98194925f38214e3ff84521df78b1c5b4202c1508ee
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.0
|