Visualize Nmap scans with live progress bars, smooth color gradients, and a countdown timer. Simple, fast, hassle-free! (No API-keys required!)

This PowerShell script wraps Nmap and provides a clean, real-time console UI while a scan is running. It parses Nmap timing output, displays multiple progress bars (Main / SYN / Service / NSE), and shows the full Nmap results only after the scan completes.

• Displays live ASCII progress bars:
• Smooth color gradient on the growing arrow (=====>)
• Countdown timer (ETA)
• Stable, flicker-free rendering
• Clean final output

• PowerShell 7.x (recommended)
• Nmap installed
• ANSI-compatible terminal (for colors and cursor control)

• Nmap: Network scanning engine

• PowerShell: Make sure PowerShell 7+ is installed.

Clone the repository or download the script:

git clone https://github.com/MijsBjornPXL/nmapbar.git
cd nmapbar

After installing the requirements, you can run the script directly from PowerShell.

Example Simple Scan:

.\nmapbar.ps1 -Mode simple 192.168.1.1

Example Complete Scan:

.\nmapbar.ps1 -Mode complete 10.0.14.5

Custom Nmap Path:

.\nmapbar.ps1 -Mode simple 192.168.1.1 `
  -NmapPath "C:\Program Files (x86)\Nmap\nmap.exe"

The script supports two scan modes:

simple

Uses: -sV -sC -n

Balanced scan suitable for most situations

complete

Uses: -sS -A -p- -n -T4

More extensive and slower scan

Both modes include:

--stats-every 250ms

Live Progress UI:

Main Progress [=========================>            ]  53%  Running. 53%, 2m14s
SYN Scan      [===============================>     ]  82%
Service Scan  [===============>                     ]  41%
NSE Scan      [>                                    ]   2%

The =====> arrow gradually changes color from red to green as progress increases.

Final Nmap Output:

PORT     STATE SERVICE
22/tcp   open  ssh
80/tcp   open  http
443/tcp  open  https

If you encounter issues while running the script, ensure that:

• Nmap is installed and accessible
• You are using PowerShell 7 or newer
• Your terminal supports ANSI escape sequences
• If Nmap is not in PATH, use the -NmapPath parameter

This project is licensed under the MIT License - see the LICENSE file for details.