Skip to content

A multi-threaded network reconnaissance and reporting tool.

Notifications You must be signed in to change notification settings

Dhy4n-117/ViperScan

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🐍 ViperScan

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.

ViperScan Dashboard

🚀 Features

  • High-Speed Scanning: Utilizes concurrent.futures for 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).

🛠️ Installation

  1. Clone the repository:

    git clone https://github.com/dhy4n-117/ViperScan.git
    cd ViperScan
  2. Install dependencies:

    pip install -r requirements.txt

💻 Usage

Basic Scan:

python main.py -t google.com

Advanced 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.html

⚠️ Disclaimer

This tool is for educational purposes and authorized security testing only. Scanning networks without permission is illegal.