first commit

README.md

@@ -0,0 +1,116 @@
+# WiFi Cracking Package
+## Complete CAP/PCAP Cracking Workflow with Handshake Verification
+
+### Quick Start
+```bash
+# 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
+```bash
+# 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
+```bash
+# 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
+```bash
+# 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