Skip to content
Projects

Author · 2026

Portscout

A terminal UI for nmap, with the scanning core kept off nmap, the filesystem, and the interface.

Python · nmap

github.com/edglz/portscout

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.

0:00