Skip to content

dreizehnutters/NmapView

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

63 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

NmapView – Nmap XML Report Viewer

Latest Release CI Demo Report Download Standalone XSL Stats

Stop staring at raw XML. Get instant, interactive insights.

NmapView transforms flat Nmap XML into a single, portable, interactive HTML dashboard for analysis and triage.

No backend, no database, and no reporting pipeline required. Open it locally and review hosts, open services, service variants & visualizations in one file. Share it, export from it, or archive it.

Report Screenshot

> Open Demo Report <

> Blog Post <

Quick Start

Render any existing Nmap XML file in seconds using xsltproc (pre-installed on most Linux/macOS systems):

# 1. Download the latest stylesheet
curl -fsSL -o NmapView.xsl https://github.com/dreizehnutters/NmapView/releases/latest/download/NmapView.xsl

# 2. Transform your scan
xsltproc -o report.html NmapView.xsl scan.xml

Open the generated HTML file in your browser.

Optional: Convenience Mode

As an alternative to xsltproc, you can transform Nmap XML files directly in your browser using NmapView.

> NmapView Web Transformer <

Nmap XML data is processed entirely client-side. No network transmission of scan data.

Why Try It

  • Turn raw XML into a report you can read and share without extra tooling
  • Review hosts, open services, service variants, and host details in one place
  • Search, sort, highlight, and export data to find "low-hanging fruit"
  • Visualize technical scan data into insightful plots
  • Keep the result as one portable HTML file

Core Features

  • Single-file interactive HTML output
  • Searchable, sortable tables
  • Export to CSV, Excel, and JSON
  • Global keyword highlighting
  • Portable output you can share or archive

Report Sections

  • Host Overview: Triage hosts by IP, hostname, vendor, OS guess, open TCP/UDP port counts or service rarity.
  • Host Scope: Keep or exclude visible hosts and recalculate downstream tables, exports, and plots against only that selected subset.
  • Open Services: Review exposed services across hosts with versions, extra info, CPEs lookup links via CVEHunter, and Vulners-linked context.
  • Service Summary: Group service and NSE output by service, port, product, and version so repeated software, web stacks, and unusual variants stand out across hosts.
  • Host Details: Drill into each host scanned ports and corresponding complete script output

Visualizations

  • Open Ports Per Host: Compare exposure across systems at a glance.
  • Operating System Distribution: See which OS families dominate the environment and where platform diversity or concentration stands out.
  • Service Distribution Across Hosts: See which services are most widespread and which appear on only a few hosts.
  • Host-Service Relationships: See which services are shared across hosts and which are isolated.
  • Host-Port Matrix: See which ports appear on which hosts and spot unusual exposure patterns.
  • Service-Port Heatmap: Confirm expected port usage and spot unusual service-to-port combinations.

Requirements

  • xsltproc to transform XML into HTML

No Python, Node, or backend required.

Typical Use Cases

  • Internal network assessments
  • External attack surface reviews
  • Pentest evidence packaging
  • Asset and service inventory review
  • Comparing repeated service exposure across hosts
  • Sharing scan results with engineers, clients, or internal stakeholders
  • Reviewing large scans without working through raw XML

For Contributors

PRs are welcome.

  • xsl/: split XSL source
  • tools/: build helper, checks, and local XML fixtures

Build the standalone stylesheet with:

python3 tools/build_xsl.py

Feedback

If the project is useful and saved you an hour of manual grepping today, star it. Open an issue for bugs, UX friction, or feature requests.

Acknowledgment & Credits

Special thanks to the foundations laid by:

About

NmapView – Nmap XML Report Viewer | Turn Nmap XML into a searchable, portable HTML report for analysis, triage, and pentest reporting.

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

 

Contributors