ViperScan is a multi-threaded network reconnaissance tool designed for security professionals and CTF players. It automates port scanning, service fingerprinting, and OS detection, presenting results in a modern HTML dashboard.
- High-Speed Scanning: Utilizes
concurrent.futuresfor multi-threaded execution, significantly faster than sequential scanning. - Service Fingerprinting: Automatically grabs banners (HTTP, SSH, FTP) to identify running services.
- Intelligent Reporting: Generates a dark-mode HTML Dashboard for easy analysis.
- Colorized CLI: Clear, color-coded terminal output for real-time feedback.
- OS Heuristics: Analyzes banners to estimate the target Operating System.
- Change Detection Engine: Uses SQLite to track scan history and alerts on new/changed ports (Stateful Analysis).
- Venom Module: automated vulnerability assessment for common protocols (HTTP Headers, Anonymous FTP).
-
Clone the repository:
git clone https://github.com/dhy4n-117/ViperScan.git cd ViperScan -
Install dependencies:
pip install -r requirements.txt
Basic Scan:
python main.py -t google.comAdvanced Scan: Scans ports 1-500 with 50 threads and saves an HTML report.
python main.py -t 192.168.1.105 -p 1-500 --threads 50 -o scan_results.htmlThis tool is for educational purposes and authorized security testing only. Scanning networks without permission is illegal.
