voidheart33/WiFi-Pentest-Suite

# WiFi Pentest Suite Advanced Wireless Auditing & Automation Framework for Linux environments. ## Overview WiFi Pentest Suite is a Python-based wireless security auditing framework designed to automate common Wi-Fi penetration testing workflows. The tool integrates multiple offensive wireless utilities into a single interactive CLI interface, simplifying tasks such as: - Monitor mode management - Wireless reconnaissance - WPA/WPA2 handshake capture - Deauthentication attacks - Dictionary-based cracking - Dynamic wordlist generation - WPS auditing and Pixie Dust attacks - Wireless toolkit deployment The framework acts as an orchestration layer over tools from the Aircrack-ng ecosystem and other wireless auditing utilities. ## Features ### Wireless Interface Management - Enable monitor mode - Disable monitor mode - Automatically kill conflicting processes - Restart NetworkManager services ### Wireless Reconnaissance - Passive Wi-Fi scanning - WPS-enabled network discovery - Real-time packet monitoring - ESSID/BSSID enumeration - Channel identification ### WPA/WPA2 Auditing - Handshake capture automation - Integrated deauthentication attacks - Handshake cracking using: - `rockyou.txt` - Custom wordlists - On-the-fly generated dictionaries ### WPS Auditing Supports multiple WPS attack methods: - Reaver - Bully - PixieWPS - Wifite integration ### Wordlist Operations - Custom wordlist generation using `crunch` - Character-set based generation - Pipe-based real-time cracking - Brute-force automation ### Wireless Toolkit Installer - Aircrack-ng - Wifite - Reaver - PixieWPS - Kismet - Fern Wifi Cracker - Bully - KillerBee - mdk3 - And many others ## Supported Attacks | Attack Type | Supported | |---|---| | WPA/WPA2 Handshake Capture | Yes | | Deauthentication | Yes | | Dictionary Attack | Yes | | Brute Force Attack | Yes | | WPS PIN Attack | Yes | | Pixie Dust Attack | Yes | | Wireless Reconnaissance | Yes | ## Requirements ### Operating System - Kali Linux (recommended) - Parrot OS - Ubuntu-based distributions ### Python Version - Python 3.x ### Root Privileges The tool requires root access for: - Monitor mode operations - Packet injection - Wireless interface manipulation ## Dependencies The framework automatically installs required packages: apt-get install aircrack-ng crunch xterm wordlists reaver pixiewps bully wifite Additional supported tools: kismet cowpatty mdk3 multimon-ng fern-wifi-cracker ghost-phisher killerbee spooftooph wifi-honey ## Installation Clone the repository: git clone https://github.com/viieiramatheuss/wifi-pentest-suite.git cd wifi-pentest-suite Make the script executable: chmod +x wifi-pentest-suite.py Run the framework: sudo python3 wifi-pentest-suite.py ## Usage ### Start Monitor Mode airmon-ng start wlan0 ### Scan Wireless Networks airodump-ng wlan0mon -M ### Capture WPA Handshake airodump-ng wlan0mon --bssid -c -w capture Simultaneous deauthentication: aireplay-ng -0 10 -a wlan0mon ### Crack Handshake Using RockYou: aircrack-ng capture.cap -w /usr/share/wordlists/rockyou.txt Using Custom Wordlist: aircrack-ng capture.cap -w custom.txt ### Generate Wordlists crunch 8 12 abc123 -o wordlist.txt ### WPS Attack Using Reaver: reaver -i wlan0mon -b -vv Using Pixie Dust: reaver -i wlan0mon -b -K ## Internal Workflow The framework primarily automates execution of: airmon-ng airodump-ng aireplay-ng aircrack-ng reaver pixiewps bully crunch wifite The script dynamically constructs shell commands using user-provided parameters and executes them through Python's `os.system()` interface. ## Architecture ### Core Components | Module | Purpose | |---|---| | Interface Manager | Monitor mode operations | | Recon Engine | Wireless scanning | | Handshake Module | Capture automation | | Cracking Engine | WPA/WPA2 attacks | | WPS Engine | WPS exploitation | | Wordlist Generator | Dynamic dictionary generation | | Package Installer | Dependency management | ## Security Notice This project is intended strictly for: - Authorized penetration testing - Wireless security research - Lab environments - Educational purposes - Red team simulations Unauthorized access to wireless networks is illegal in many jurisdictions. The developer assumes no liability for misuse or damage caused by this software. ## Known Limitations - Heavy reliance on external binaries - Requires compatible wireless adapters with monitor mode support - Minimal input sanitization - Uses `os.system()` for command execution - No asynchronous task handling - No session persistence - No PCAP validation ## Recommended Hardware ### Wireless Adapters Chipsets recommended for packet injection: - Atheros AR9271 - Realtek RTL8812AU - Ralink RT3070 ### External Adapters Recommended: - Alfa AWUS036NHA - Alfa AWUS036ACH - Panda PAU09 ## Future Improvements Planned enhancements: - Replace `os.system()` with `subprocess` - Add asynchronous task execution - Improve error handling - PCAP validation engine - JSON logging support - Multi-target attack support - Plugin architecture - TUI/GUI frontend - Docker deployment - Automatic handshake verification ## Example Menu # Interface Preview The framework provides an interactive terminal-based interface designed for fast wireless auditing operations, monitor mode management, WPA/WPA2 handshake workflows, WPS exploitation, and automated cracking utilities.

### Interface Features - Interactive CLI menu system - ANSI colored terminal UI - WPA/WPA2 attack automation - WPS attack modules - Wireless reconnaissance engine - Handshake capture workflows - Integrated cracking operations - Wordlist generation utilities - Wireless toolkit installer The interface is optimized for Kali Linux terminal environments and external wireless adapters supporting monitor mode and packet injection. ## Author Developed by: viieiramatheuss