WiFi Cracking Package

Complete CAP/PCAP Cracking Workflow with Handshake Verification

Quick Start

# 1. Make scripts executable
chmod +x auto_crack.sh scripts/*.sh

# 2. Place your CAP/PCAP files in the input/ directory
mkdir -p input
cp /path/to/your/*.cap input/
cp /path/to/your/*.pcap input/

# 3. Run the automation
./auto_crack.sh

What's Included

• Main Automation Script (auto_crack.sh) - Complete workflow
• Handshake Verification (scripts/verify_handshakes.sh) - Pre-cracking validation
• Wordlist Builder (scripts/build_wordlist.sh) - Smart wordlist generation
• Cracking Pipeline (scripts/crack_pipeline.sh) - Hashcat automation
• Custom Rules (rules/) - Password mutation rules
• Documentation (docs/) - Detailed guides and examples

Directory Structure

wifi_cracking_package/
├── auto_crack.sh              # MAIN SCRIPT - Run this
├── README.md                  # This file
├── scripts/                   # All automation scripts
│   ├── verify_handshakes.sh   # Handshake validation & statistics
│   ├── build_wordlist.sh      # Wordlist generation
│   └── crack_pipeline.sh      # Hashcat cracking
├── rules/                     # Hashcat rule files
│   ├── custom.rule           # Custom password mutations
│   └── best64.rule           # Common rule set
├── docs/                      # Documentation
│   ├── workflow.md           # Complete workflow guide
│   └── troubleshooting.md    # Common issues & solutions
└── input/                     # PLACE YOUR CAP/PCAP FILES HERE

Features

1. Smart Handshake Verification - Validates CAP/PCAP files before cracking
2. Automated Wordlist Management - Downloads, combines, and optimizes password lists
3. Rule-Based Attacks - Uses hashcat rules for password mutations
4. Batch Processing - Handles multiple files automatically
5. Comprehensive Reporting - Generates detailed results and statistics
6. Error Recovery - Handles failures gracefully with logs

Workflow Steps

1. System Check - Verifies tools and dependencies
2. Handshake Verification - Validates capture files (NEW!)
3. Wordlist Generation - Builds optimized password lists
4. CAP/PCAP Conversion - Converts to hashcat format
5. Hashcat Cracking - Runs dictionary + rule attacks
6. Results Reporting - Generates comprehensive reports

Handshake Verification

# Run verification separately
./scripts/verify_handshakes.sh

# Checks for:
# - Valid EAPOL handshakes (4-way handshake)
# - PMKID captures
# - Capture quality and statistics
# - Network identification (SSID/BSSID)

Installation

# Install required tools
sudo apt update && sudo apt install -y hashcat hcxtools curl wget tshark

# Or use the auto-install feature in auto_crack.sh

Usage Examples

# Basic usage
./auto_crack.sh

# Manual step-by-step
./scripts/verify_handshakes.sh
./scripts/build_wordlist.sh
./scripts/crack_pipeline.sh

# Custom wordlists
cp ~/wordlists/rockyou.txt input/wordlists/
cp ~/hashcat/rules/*.rule rules/

Output

• Cracked Passwords: results/all_cracked.txt
• Verification Reports: verification/handshake_report_*.txt
• Process Logs: auto_crack.log
• Hashcat Potfile: results/cracking_potfile.txt

Requirements

• Linux environment (WSL2, Ubuntu, Kali Linux)
• Hashcat + hcxtools installed
• 4GB+ RAM, 10GB+ disk space
• CAP/PCAP files with valid WPA/WPA2 handshakes

Legal Notice

FOR AUTHORIZED SECURITY TESTING ONLY Use only on networks you own or have explicit permission to test. Comply with all applicable laws and regulations.

Support

1. Check auto_crack.log for errors
2. Run ./scripts/verify_handshakes.sh to validate captures
3. Ensure CAP/PCAP files contain valid handshakes
4. Verify system has required tools installed