⚡ WIPWN - WiFi Pentesting Framework

Crack WPS. Audit WiFi. Learn Cybersecurity.
Built for Termux • Root Required • Ethical Use Only

---

⚠️ Disclaimer:
This tool is for educational and authorized penetration testing only.
Do NOT use on unauthorized networks.
The author is not responsible for any misuse.

---

✨ Features

• 🔍 Scan WPS-enabled WiFi networks
• ⚡ Pixie Dust attack automation
• 🔓 Online WPS PIN bruteforce
• 💾 Auto-save cracked PINs and config
• 🧪 Bash launcher for quick access
• 🐧 Built for rooted Android + Termux

---

📦 Requirements & Packages

• ✅ Rooted Android device
• ✅ Termux installed (Download here)
• ✅ WiFi chipset with monitor mode
• ✅ Internet connection for setup

📥 Required Termux Packages

Package	Description	Link
python	To run the main script	Termux Wiki
tsu	Root privileges in Termux	Termux Wiki
iw	Wireless device management	Linux man page
pixiewps	Pixie Dust WPS attack tool	Kali Tools
openssl	Crypto operations	Termux Wiki
wpa_supplicant	WiFi authentication	Arch Wiki
git	Clone repository	Termux Wiki

---

⚙️ Installation

pkg update && pkg upgrade -y
pkg install root-repo -y
pkg install git python wpa-supplicant pixiewps iw openssl -y
# Install tsu for root access. If tsu not working, install sudo instead:
pkg install tsu -y || pkg install sudo -y

git clone https://github.com/anbuinfosec/wipwn
cd wipwn
chmod +x main.py

---

🚀 Usage

Command	Description
sudo python main.py --help	Show help options
sudo python main.py -i wlan0 -K	Scan and auto attack
sudo python main.py -i wlan0 -b <BSSID> -K	Attack specific BSSID
sudo python main.py -i wlan0 -b <BSSID> -B -p 1234	Bruteforce using PIN prefix
bash wipwn.sh	Use Bash launcher

---

🛠 Troubleshooting

Issue	Fix
Device or resource busy (-16)	Toggle WiFi ON → OFF and retry
No networks found	Turn on Hotspot + Location
Permission error	Use tsu or sudo

---

🖼️ Screenshots

Scan	Cracked PIN	Saved Data	Config

---

🗂️ File Structure

📁 wipwn/
├── assets/           → Logo and screenshots
├── colors.py         → Terminal color helper
├── config.txt        → Output config format
├── LICENSE           → MIT License
├── main.py           → Main WiFi attack script
├── README.md         → Project documentation
├── vulnwsc.txt       → Vulnerable BSSID database (sample)
└── wipwn.sh          → Bash launcher script

---

---