This project is a streamlined, Python-based wrapper for Nmap, designed for systems administrators and security researchers who need a robust, automated way to perform network reconnaissance. It transitions from a collection of fragmented scripts into a cohesive, secure, and modular architecture that prioritizes safety and code reusability.
The suite provides a centralized engine that handles secure command execution and output formatting, allowing users to focus on data analysis rather than command-line syntax.
Key Features Modular Reconnaissance: Includes dedicated modules for Network Discovery, Port Scanning, OS Detection, and Aggressive Scanning.
Secure Execution: Replaced vulnerable shell-based command execution with secure subprocess calls to prevent command injection.
Intelligent Parsing: Automatically extracts relevant data from raw Nmap output and presents it in clean, scannable ASCII tables.
Robust Validation: Features enhanced IP, CIDR, and domain name validation using Python's ipaddress and socket libraries.
Root Enforcement: Built-in sudo checks ensure the tool has the necessary permissions for low-level packet crafting and OS fingerprinting.
Architecture Overview The project is organized into three primary components to ensure the code remains DRY (Don't Repeat Yourself):
main.py: The entry point featuring an interactive menu-driven interface.
scanners.py: Contains the logic for specific scan types and their corresponding output parsers.
utils.py: The core engine managing input validation, secure command execution, and table formatting.