Author · 2026
Portscout
A terminal UI for nmap, with the scanning core kept off nmap, the filesystem, and the interface.
Python · nmap
Portscout is a keyboard-driven terminal UI for nmap.
The architecture is hexagonal. The domain core has no dependencies. Adapters cover nmap, TOML configuration, and dependency checks, so the scanning core stays separate from nmap, the filesystem, and the interface.
Ports and targets are value objects that validate themselves. An invalid scan cannot be built, which also closes the command-injection surface. Progress bars are parsed from nmap’s live statistics, with streaming logs next to them.
Scan profiles, themes, persisted configuration, a dependency doctor, and a responsible-use disclaimer sit around that core. The project is linted with ruff, type-checked with mypy, and unit-tested with pytest.