Professional WiFi scanner with educational security interface for Tufty Badge
A real-time WiFi analysis tool featuring genuine network scanning and an educational deauthentication simulator for learning penetration testing concepts.
UNAUTHORIZED USE IS ILLEGAL
WiFi deauthentication attacks without explicit authorization are illegal in most jurisdictions. This tool is ONLY for:
- ✅ Networks YOU own
- ✅ Authorized security assessments with written permission
- ✅ Educational purposes in controlled lab environments
You are responsible for compliance with all applicable laws.
- Real-time network detection using
wlan.scan() - Color-coded signal strength visualization (SSID, bars, and channel match signal color)
- Network details: SSID, BSSID, Channel, Security, RSSI
- Auto-sorted by signal strength (strongest first)
- Smooth scrolling with dynamic list sizing
- Scrollable list adapts to any number of networks
- Target selection interface with scrolling SSID for long names
- Real-time packet counter with pulsing animation
- Compact layout optimized for screen size
⚠️ NO RF TRANSMISSION - purely educational UI
| Mode | Button | Action |
|---|---|---|
| Scanner | UP/DOWN | Navigate network list |
| A | Rescan networks | |
| B | Select target | |
| Target | A | Start simulation |
| B | Return to scanner | |
| Simulation | B | Stop and return |
| All Modes | HOME | Exit to menu |
🟢 Green -50 dBm+ Excellent
🔵 Cyan -50 to -60 Good
🟡 Yellow -60 to -70 Fair
🟠 Orange -70 to -80 Weak
🔴 Red -80 dBm- Very Weak
- Ch - WiFi channel (1-14)
- SEC - Network has encryption
- AP Count - Total networks detected (header)
| Requirement | RP2350 WiFi | Status |
|---|---|---|
| Monitor Mode | ❌ Not available | STA/AP only |
| Raw 802.11 Injection | ❌ Not exposed | No low-level API |
| Promiscuous Mode | ❌ Not supported | Driver limitation |
| Channel Locking | ❌ Not available | Normal operation only |
What This Means:
- ✅ Scanner uses real
wlan.scan()- fully functional - ✅ UI demonstrates security tool workflows
- ❌ No actual deauth packets transmitted
- 📚 Educational interface for learning concepts
Real Deauth Requires:
- Specialized WiFi adapter with monitor mode
- Custom firmware or Linux with proper drivers
- Tools like aircrack-ng suite
Tufty RP2350 WiFi Stack
├─ STA Mode ✓ (Station - connects to networks)
├─ AP Mode ✓ (Access Point - creates networks)
└─ Monitor Mode ✗ (Packet injection/sniffing)
-
Copy the folder:
cp -r wifi_tool /apps/
-
Restart Tufty or return to home menu
-
Launch "Wifi Tool" from apps
For offline development without WiFi hardware:
# In __init__.py, line ~30:
DevConfig.TEST_MODE = True- 5GHz support (hardware permitting)
- Network history tracking
- Signal strength graphs
- Export scan results
- WPA handshake capture simulation
- Beacon frame analysis
- Channel utilization graphs
- Interactive security quiz
- Unit test framework
- Mock hardware interfaces
- Logging system
- Event queue input handling
Config Layer → State Model → Hardware Abstraction
↓
UI Components ← Dispatch Tables → Handlers
↓
Smooth Scroll Animation (easing interpolation)
Key Design Principles:
- ✓ Dependency injection (no tight coupling)
- ✓ State parameter passing (testable components)
- ✓ Centralized animations (consistent timing)
- ✓ Dispatch tables (scalable state machine)
- ✓ Smooth scrolling with easing (dynamic visible items)
- ✓ Clean separation: handlers mutate state, renderers only draw
Enable test mode to generate fake networks:
DevConfig.TEST_MODE = TrueAll components accept state parameters for unit testing without hardware.
- WiFi network structure and metadata
- Signal strength interpretation (RSSI)
- Security concepts (encryption, authentication)
- Penetration testing tool workflows
- Embedded UI development patterns
| ✅ DO | ❌ DON'T |
|---|---|
| Test your own networks | Attack without permission |
| Use in authorized pen tests | Disrupt critical infrastructure |
| Learn about WiFi security | Interfere with public WiFi |
| Document vulnerabilities | Use for malicious purposes |
Networks not appearing?
- Ensure WiFi is enabled
- Press A to rescan
- Move closer to access points
- Check if 2.4GHz only (5GHz may not be supported)
Questions about deauth mode?
- Deauth is UI simulation only
- No packets transmitted over the air
- Educational demonstration of security concepts
- Real deauth requires specialized hardware
This tool provides REAL WiFi scanning and SIMULATED deauth for EDUCATIONAL purposes only.
The deauth functionality is UI-only and does not transmit actual packets. Real deauth attacks require specialized hardware and are illegal without authorization. The authors are not responsible for any misuse of this software.
Ideas for improvement? Open an issue or submit a pull request!
- Additional scan filters
- Network comparison tools
- Better signal visualization
- More educational content
Built with ❤️ for the Tufty Badge community
Remember: With great power comes great responsibility. Use this tool ethically and legally.