termmap guide: from install to first scan

Everything termmap does, in the order you need it. Five minutes from tarball to a port list.

1. Install the requirements

sudo apt install python3 nmap

sudo dnf install python3 nmap     # Fedora
sudo pacman -S python nmap        # Arch
brew install nmap                 # macOS

2. Root only for OS and UDP

nmap needs raw sockets for -O and -sU. Without root those two buttons show a message instead of starting a scan that would fail. Everything else works as a normal user.

termmap
sudo termmap

3. Install termmap

tar xzf termmap-0.1.tar.gz
cd termmap-0.1
sudo ./install.sh

PREFIX="$HOME/.local" ./install.sh

4. Run it

termmap

Keyboard reference

Key	Action
`Tab`	Switch between output and buttons
`Enter`	Run the scan or open the dialog
`Up` / `Down`, `PgUp` / `PgDn`	Scroll the output
`g` / `G`	Top / bottom
`t` / `p` / `x`	Edit target, ports, options
`s`	Save to `~/nmap-<time>.txt`
`Esc`	Stop the running scan
`?`	Help
`q`	Quit

Mouse and terminals

Where the terminal reports mouse events, the buttons and fields are clickable. The keyboard always works. Use a terminal of at least 80x24 with a UTF-8 locale; after a crash, reset restores the screen.

Removing data, safely

termmap writes nothing except when you press s. Saved files are plain text in your home directory; delete them like any other file.

Troubleshooting

"Could not start nmap"

nmap is not at /usr/bin/nmap or not installed. Check with command -v nmap and install it from the package manager.

"This scan needs root"

OS detection and UDP scans use raw sockets. Run sudo termmap or use another preset.

A scan takes very long

Deep and Svc already use --version-light and a host timeout. For a filtered host add -Pn; for a subnet, run Ping first.

Uninstall

sudo rm /usr/local/bin/termmap

command -v nmap || sudo apt install nmap