🧪 Nmap TUI Viewer (Work in Progress)

A lightweight terminal UI tool for reviewing and navigating nmap scan results.

This project is built to improve readability and workflow during external penetration tests, especially when dealing with large scans containing hundreds of hosts.

---

🚧 Status

⚠️ This project is currently a work in progress, so it might not work as expected while it’s being developed.

---

🎯 Purpose

Standard nmap output becomes difficult to manage at scale. This tool aims to provide:

• A structured, interactive view of scan results
• Faster host review during assessments
• Visual prioritisation of open ports and services
• Basic workflow tracking (e.g. reviewed hosts)

---

🖥️ Features (Current)

• Terminal-based UI

• Host list + details panel

• Color-coded port states:

  • 🟢 open
  • 🟡 filtered
  • 🔴 closed

• Keyboard navigation

• Mark hosts as reviewed (r)

• Load .nmap scan files

---

⌨️ Controls

• ↑ / ↓ → Navigate hosts
• r → Toggle reviewed status
• q → Quit

---

⚙️ Build & Run

Requirements

• Rust (latest stable)

Run

cargo run --release -- scan.nmap

---

📦 Dependencies

• ratatui – Terminal UI rendering
• crossterm – Input handling and terminal control

---

🧭 Roadmap (Planned)

• Save/load reviewed state
• Filtering by port or service
• Host tagging (e.g. web, domain controller, high value)
• Support for XML (-oX) Nmap output
• Search functionality
• Notes per host

---

⚠️ Disclaimer

This tool is intended for authorised security testing only. Do not use it on networks or systems without explicit permission.

---