Manage. Monitor. Audit. A dark-themed GTK3 desktop application that centralizes WiFi adapter management, monitor-mode operations, and 100+ curated wireless security tools in one professional interface.
WAIFI is a professional, desktop-focused WiFi penetration testing suite for Kali Linux and compatible Debian-based distributions. It centralizes every stage of a wireless security assessment — from adapter management to capture organization to HTML report generation — in a single, dark-themed desktop application.
Built for ethical security professionals, penetration testers, and students who need a unified, auditable workflow for wireless security assessments.
┌─────────────────────────────────────────────────────────┐
│ WAIFI DESKTOP APP │
│ (GTK3 · Dark Theme) │
│ │
│ 📡 Adapter Mgmt → Auto-detect · Mode switch │
│ 📻 Monitor Mode → One-click · Channel control │
│ 🛠️ Tools Browser → 100+ grouped tools │
│ 🗃️ Loot Locker → Capture management │
│ 📋 Reports → HTML executive summaries │
│ 🖥️ Terminal → Integrated output viewer │
└─────────────────────────────────────────────────────────┘
| Feature | Description |
|---|---|
| 📡 Adapter Management | Auto-detect WiFi interfaces, chipset/driver info, simplified mode switching |
| 📻 Monitor Mode Control | One-click monitor mode + channel selection |
| 🛠️ 100+ Integrated Tools | Scanning, cracking, WPS, rogue APs, packet analysis, post-exploitation |
| 🗃️ Loot Locker | Automated capture management and workflow organization |
| 🖥️ Dark GTK3 UI | Tabbed navigation with integrated terminal output |
| 📋 HTML Reports | Exportable professional executive summaries |
| 🔒 Privacy-First | Local-only, no telemetry, no external data transmission |
| 🔍 Audit Trail | Scope, timing, and authorization documentation support |
| Category | Example Tools |
|---|---|
| Scanning | Airodump-ng, Kismet, Wash |
| Cracking | Aircrack-ng, Hashcat, John the Ripper |
| WPS Attacks | Reaver, Bully, Pixiewps |
| Rogue APs | Hostapd, MDK4, Airbase-ng |
| Packet Analysis | Wireshark, Tcpdump, Tshark |
| Post-Exploitation | Hcxtools, Hcxdumptool, Macchanger |
Kali Linux or Debian-based OS • Python 3.8+ • Root/sudo
WiFi adapter with monitor mode capability
sudo apt-get update
sudo apt-get install -y \
python3-gi python3-gi-cairo gir1.2-gtk-3.0 gir1.2-vte-2.91 \
aircrack-ng mdk4 hcxtools reaver bully pixiewps hashcat macchangergit clone https://github.com/gnonymous1/WAIFI.git
cd WAIFI
pip3 install -r requirements.txt
chmod +x install.sh
sudo ./install.sh# Terminal launch (requires root)
sudo python3 wifi_pentest_app.py
# Desktop menu (after installation)
# Search "WAIFI" in your application launcher1. 📡 Select adapter → Adapter Management tab
2. 📻 Enable monitor mode → Confirm chipset support
3. 🔍 Scan networks → airodump-ng integrated view
4. 🎯 Select target → Tools Browser
5. 🛠️ Run tool → Set params in integrated runner
6. 🗃️ Save captures → Loot Locker (encrypted path)
7. 📋 Generate report → HTML executive summary
WAIFI is built privacy-first from the ground up:
- Local-first — all captures, logs, and artifacts stored on your filesystem only
- No telemetry — zero usage analytics or external data transmission by default
- You control retention — explicit guidance on secure storage and deletion
# Encrypt captures immediately after acquisition
gpg --symmetric --cipher-algo AES256 capture.cap
# Secure delete when no longer needed
shred -u capture.cap
# Store on encrypted volume (LUKS / VeraCrypt)☐ Obtain explicit written authorization from network owner
☐ Use a dedicated, hardened testing machine
☐ Store captures on encrypted storage
☐ Limit scope to authorized devices and channels
☐ Log engagement start/stop times and authorization reference
WAIFI/
│
├── 🖥️ wifi_pentest_app.py Main GTK3 application entry point
│
├── 🧩 modules/ Feature modules
│ ├── adapter.py Adapter detection and management
│ ├── monitor.py Monitor mode operations
│ ├── tools.py Tool browser and runner
│ └── loot.py Capture management
│
├── 🎨 gui/ GTK3 UI components
├── 📜 scripts/ Helper shell scripts
├── 🧪 tests/ Test suite
├── 📦 resources/ Icons and assets
│
├── 📋 requirements.txt Python dependencies
├── 🔧 install.sh Dependency installer
├── 🚀 run.sh Launcher script
├── 🧹 cleanup.sh Cleanup and restore interfaces
└── 🖥️ wifi-pentest.desktop Desktop launcher entry
| Symptom | Cause | Fix |
|---|---|---|
| Adapter not detected | Driver/chipset not supported | Run sudo ifconfig -a and iw list |
| Monitor mode fails | Conflicting processes | sudo airmon-ng check kill then retry |
| Tool missing | Not installed | sudo apt-get install <tool> |
| GTK import error | Missing GObject libs | Re-run apt-get install python3-gi python3-gi-cairo |
WAIFI supports producing reproducible, professional reports:
Report Structure:
├── Executive Summary
├── Scope & Authorization
├── Methodology
├── Findings (risk-ranked)
├── Evidence (redacted)
├── Remediation Guidance
└── Appendix (tool commands · timestamps · authorization proofs)
Export to HTML for client delivery or internal audit records.
- PDF report export
- Network topology visualization
- Automated vulnerability correlation
- Plugin system for community tool additions
- Integrated hashcat pipeline (capture → crack)
- WPA3 Dragonblood assessment module
WAIFI is for authorized security testing, research, and education only.
- You must have explicit written permission to test any network or device
- Unauthorized use may be illegal in your jurisdiction
- By using WAIFI you confirm you understand and accept these responsibilities
- Never upload captures containing PII or credentials to public services
We welcome contributions that improve security, usability, privacy controls, and documentation.
git checkout -b feature/secure-storage
# Make changes + test
git commit -m "feat: add secure storage workflow"
# Open a Pull RequestSee CONTRIBUTING.md for full guidelines.
🐛 Report Bug • ✨ Request Feature • 💬 Discuss
Stay ethical — protect privacy, document authorization, report responsibly.