QMap Concurrent Scanner

What is QMap?

QMap is a menu-driven front end to Nmap that simplifies scanning tasks. It supports single-target scans, concurrent multi-target scans (with rate-limiting), progress and ETA estimation, and automatic machine-readable output files (grepable / XML / all).

System Requirements (what you must install)

Nmap	QMap requires the Nmap scanner. Install and ensure it's in your PATH. Linux (Debian/Ubuntu): sudo apt update && sudo apt install nmap -y macOS (Homebrew): brew install nmap Windows: Download from https://nmap.org/download.html and enable "Add Nmap to PATH".
Go	Only required if you plan to build from source. Otherwise use the provided executable. Recommended Go ≥ 1.20. Verify with go version.
Sudo / Admin	Needed only for some scan types (SYN, UDP). On Linux, QMap can use sudo. On Windows, run as Administrator for full functionality.
Zip (optional)	Only needed if you use the build script and want to create ZIP archives. Not required to run QMap.

How to Run QMap (quick)

Open a terminal (or Command Prompt on Windows) and run the executable in the same folder.

Linux:
  ./qmap

Windows:
  qmap.exe

If a scan needs privileges, run:
  sudo ./qmap   (Linux)

Or start your Windows terminal as Administrator.

Main Menu — what each item does

1) Run single target
   - Scan one IP or hostname.
2) Run multiple targets from file (concurrent)
   - Provide a file with one target per line (supports comments starting with #).
   - QMap runs scans in parallel and shows progress + ETA.
3) Toggle auto-elevate (sudo / runas)
   - Turn automatic elevation on/off for scans requiring admin privileges.
4) Change default flags / choose scan
   - Choose from common flag presets or type custom Nmap flags.
5) Show predefined flags list
   - View the available scan presets.
6) Adjust concurrency
   - Set how many targets are scanned at the same time.
7) Choose output mode
   - None | -oG (grepable) | -oX (XML) | -oA (all formats)
8) Toggle save combined output
   - Save one combined file for multi-target runs.
9) Exit

Quick Examples

Example 1 — Single IP:
  1) Start QMap
  2) Choose "Run single target"
  3) Enter IP (e.g. 192.168.1.1)
  4) Choose scan flags (e.g. "Quick scan -F")
  5) View output and save if desired

Example 2 — Multiple targets:
  Create targets.txt:
    192.168.1.1
    scanme.nmap.org
  1) Start QMap
  2) Choose "Run multiple targets from file"
  3) Enter path to targets.txt
  4) Choose flags, concurrency, and output options
  5) Watch progress and save outputs

Output Files & Where to Find Them

QMap creates timestamped files in the same directory as the executable. Examples:

scan-192.168.1.1-20251109-182000.txt
scan-192.168.1.1-20251109-182000.xml
combined-scan-targets-20251109-182030.txt

Use any text editor (Notepad, nano, VSCode) to open them. XML files can be loaded into other tools that parse Nmap XML.

Tips & Troubleshooting

• "nmap: command not found" => Install Nmap and ensure it is in PATH.
• "permission denied" => Run QMap with sudo or as Administrator.
• Scans are slow: try increasing concurrency (but be careful).
• Scans fail on Windows when elevated: run QMap from an elevated PowerShell/Command Prompt.
• Never scan networks you do not have permission to test.

Important Legal Note

Only scan systems and networks that you own or are explicitly authorized to test. Unauthorized scanning can be illegal and may result in civil or criminal penalties.