A fast, modular, and ethical local network reconnaissance tool built with Scapy, socket programming, and Nmap. Designed for penetration testing labs, CTF challenges, and authorized network assessments.
- Lightning-fast ARP host discovery using Scapy (Ethernet-layer scanning)
- Custom TCP connect scan on common ports
- Accurate service & version detection with Nmap (
-sV) - Automatic Nmap installation if missing (Linux/macOS support)
- Beautiful terminal UI powered by Rich (tables, panels, colors)
- Multi-format reports: JSON and CSV export
- Ethical usage banner and timestamp
git clone https://github.com/Sudo0xSajal/eth0Scanner.git
cd eth0Scanner
pip install -r requirements.txtRun the scanner with Python 3:
python3 scanner.py-
Display an ethical usage banner.
-
Prompt you to enter the target network (e.g., 192.168.1.0/24 or 172.31.0.0/24).
-
Automatically discover live hosts, scan common ports, enumerate services, and generate reports.
-
Reports will be saved as
scan_report.jsonandscan_report.csvin the current directory.
python3 scanner.py
Enter Target Network (e.g., 192.168.1.0/24): 172.31.0.0/24eth0Scanner/
│
├── scanner.py # Main scanner script
├── host_discovery.py # Live host discovery (ARP/Ping)
├── port_scanner.py # TCP port scanning
├── service_scan.py # Service enumeration via Nmap
├── report.py # Generate JSON and CSV reports
├── pretty_output.py # Pretty CLI output (banners, tables)
├── requirements.txt # Python dependencies
└── README.md # Instructions
- For authorized testing and educational purposes only.
- Do not scan networks without explicit permission.
Sajal Haldar
- GitHub: @Sudo0xSajal
- LinkedIn: linkedin.com/in/sajalhaldar16