=========================================== QMAP CONCURRENT SCANNER =========================================== Version: 2.0 Author: K0NxT3D Platform: Linux / Windows License: MIT ------------------------------------------- Description ------------------------------------------- QMap is a powerful, easy-to-use network scanner built on top of Nmap. It allows you to: • Scan one or more targets (computers, servers, IPs, or websites) • Run multiple scans at once (parallel scanning) • See progress and estimated completion time • Automatically save results in normal, grepable, or XML formats • Run again and again — returning safely to the main menu It’s designed to make Nmap simple for everyday users and fast for advanced users. No technical background is required — if you can read menus and press numbers, you can use QMap. ------------------------------------------- System Requirements ------------------------------------------- Before running QMap, make sure your computer has the following: 1. **Nmap (the scanner engine)** QMap uses Nmap under the hood. It must be installed and available in your PATH. ▪️ Linux (Debian / Ubuntu): sudo apt update && sudo apt install nmap -y ▪️ macOS: brew install nmap ▪️ Windows: Download and install from https://nmap.org/download.html During installation, make sure to check: ✅ “Add Nmap to the system PATH for all users” Verify it works: nmap --version You should see something like: Nmap version 7.94 ( https://nmap.org ) 2. **(Linux Only) Sudo Access** Some scan types (like SYN or UDP) require administrator privileges. QMap can automatically use “sudo” when needed. 3. **Zip Utility (Optional)** Only needed if you use the provided build script to make ZIP releases. Not required to run QMap itself. ------------------------------------------- How to Run QMap ------------------------------------------- 🟩 STEP 1: Open a Terminal (or Command Prompt on Windows) Navigate to the folder containing the QMap program. 🟩 STEP 2: Run the program Linux: ./qmap_concurrent Windows: qmap_concurrent.exe If your system blocks it (especially on Windows), right-click and choose: “Run as Administrator.” ------------------------------------------- Main Menu ------------------------------------------- When you start QMap, you’ll see a simple numbered menu like this: 1) Run single target 2) Run multiple targets from file (concurrent) 3) Toggle auto-elevate (sudo / runas) 4) Change default flags / choose scan 5) Show predefined flags list 6) Adjust concurrency 7) Choose output mode (none / -oG / -oX / -oA) 8) Toggle save combined output for multi-target runs 9) Exit ------------------------------------------- How Each Option Works ------------------------------------------- 1️⃣ **Run Single Target** Type an IP or domain (for example: 192.168.1.1 or scanme.nmap.org) QMap will ask what type of scan to run (e.g., basic, service detection, full port scan, etc.) Results will appear live on your screen and be saved automatically. 2️⃣ **Run Multiple Targets from File** Prepare a plain text file, for example “targets.txt”, containing one target per line: 192.168.1.1 192.168.1.5 scanme.nmap.org You can also add comments starting with “#” — they’ll be ignored. QMap will scan several at once, based on the concurrency setting. It shows a progress indicator and an estimated time remaining. 3️⃣ **Toggle Auto-Elevate** Turn on/off automatic “sudo” (Linux) or “runas admin” (Windows). This lets QMap perform deeper scans that require privileges. 4️⃣ **Change Default Flags** Modify the Nmap command line options (for example: -sS, -sV, -A). Useful for power users who want to adjust what’s scanned. 5️⃣ **Show Predefined Flags List** Shows a ready-made list of common scan types you can choose from. 6️⃣ **Adjust Concurrency** Controls how many targets are scanned at the same time. Lower numbers = safer and slower. Higher numbers = faster but more bandwidth and CPU use. 7️⃣ **Choose Output Mode** QMap supports several Nmap output formats: - none: Just show the screen output. - -oG : Grepable format (machine-readable text) - -oX : XML format (for use with other tools) - -oA : All formats at once (-oN, -oG, -oX) 8️⃣ **Toggle Save Combined Output** When scanning multiple targets, this combines all results into one file. 9️⃣ **Exit** Closes QMap safely. ------------------------------------------- Output Files ------------------------------------------- Every scan automatically creates a timestamped output file in the same folder. Examples: scan-192.168.1.1-20251109-182000.txt scan-192.168.1.1-20251109-182000.xml combined-scan-20251109-182030.txt You can open these in any text editor (Notepad, VSCode, nano, etc.) ------------------------------------------- Tips for Better Results ------------------------------------------- • Always run QMap as Administrator or with “sudo” for accurate results. • Don’t scan networks you don’t own or have permission to scan. • If scans seem slow, increase concurrency slightly. • If your system or network gets laggy, reduce concurrency. • The “grepable” (-oG) or “XML” (-oX) modes are great for automation or importing into other tools. ------------------------------------------- Example Quick Start ------------------------------------------- Example 1 – Scan a single IP: ./qmap_concurrent -> Choose “1” for single target -> Enter 192.168.1.1 -> Choose “Basic scan (-sS)” -> View results and output file in the current folder Example 2 – Scan multiple targets: Create a file “targets.txt”: 192.168.1.1 192.168.1.2 scanme.nmap.org ./qmap_concurrent -> Choose “2” -> Enter “targets.txt” -> Watch progress bar as multiple scans run at once! ------------------------------------------- Common Problems & Fixes ------------------------------------------- ⚠️ “nmap: command not found” → Install Nmap and restart your terminal. ⚠️ “permission denied” or “requires root privileges” → Run with sudo: sudo ./qmap_concurrent ⚠️ “firewall blocking scans” → Some systems block outgoing SYN packets. Use safer scans like “-sT”. ⚠️ “Windows SmartScreen warning” → Click “More Info” → “Run Anyway.” (It’s safe if you trust the source.) ------------------------------------------- Support & Credits ------------------------------------------- Created by: K0NxT3D Built with: Go and Nmap Website: https://nmap.org (for Nmap engine reference) License: MIT (Free to use and modify) QMap is not affiliated with the Nmap project. It’s a standalone front-end designed to simplify your workflow.