Nmap Exec UI

A modern, responsive, and powerful graphical user interface for Nmap, built with Go and standard web technologies.

🚀 Features

• Modern Web UI: A clean, responsive interface with Dark and Light themes.
• Native GUI Experience: Runs as a standalone desktop application using Microsoft Edge WebView2 (via go-webview2) or as a headless web server.
• Live Output Streaming: Watch Nmap scan results stream in real-time.
• Pretty Results Table: Parses XML output into a clean, searchable, and sortable table of hosts and ports.
• Multi-Tab Support: Run and monitor multiple concurrent scans in separate tabs.
• Process Control: Stop/Cancel scans at any time.
• Comprehensive Options: Full support for Nmap's extensive option set (Target, Host Discovery, Port Spec, Scripts, Firewall Evasion, etc.).
• Dynamic Port Selection: Automatically finds an available port on 127.0.0.1.
• Secure: Binds strictly to localhost for security.
• Persistent Configuration: Theme preference is saved to config.json and persists across restarts.

📋 Prerequisites

• Nmap: You must have Nmap installed and available in your system's PATH.
• Go: Required to build the application (Go 1.16+ recommended).
• WebView2 Runtime: Included in Windows 10/11 by default. If missing, download it from Microsoft.

⚖️ Legal

• License: GNU General Public License v3 (GPLv3)
• Author: @hejhdiss
• Third-Party Libraries: See NOTICE.txt for details.

⚙️ Configuration

The application creates a config.json file in the same directory as the executable.

{
  "theme": "dark"
}

You can manually edit this file or change the theme via the UI.

🛠️ Installation & Build

1. Clone the repository (if applicable) or navigate to the project directory.

2. Build the Native GUI App (Recommended):
   bash go build -o nmap-exec-ui-app.exe ./cmd/nmap-exec-ui-app

3. Build the Headless Server (Optional):
   bash go build -o nmap-exec-ui.exe .

🖥️ Usage

Native GUI Mode

Run the app executable to launch the standalone window. This provides a desktop-app-like experience using Windows native WebView2.

.\nmap-exec-ui-app.exe

Headless Server Mode

Run the server executable to start the web server. It will print the local URL to your terminal.

.\nmap-exec-ui.exe
# Output: Server listening on http://127.0.0.1:54321

Open the provided URL in your web browser.

🏗️ Tech Stack

• Backend: Go (Golang)
• Web Framework: Gin
• GUI Wrapper: go-webview2 (Windows WebView2)
• Frontend: HTML5, CSS3 (Variables, Flexbox/Grid), Vanilla JavaScript
• Communication: Server-Sent Events (SSE) for streaming