WiFi Security Monitor
A comprehensive Python toolkit for detecting deauth attacks and monitoring network devices with behavioral analysis.
Network Security
Comprehensive network security toolkit with deauth attack detection and device monitoring
- Version: v1 (Released Dec 2025)
- Language: Python 3.7+
- License: Apache 2.0
๐ฆ View on GitHub ยท ๐ Read Blog Post
Overview
WiFi Security Monitor is an open-source Python toolkit designed to protect wireless networks from attacks and unauthorized access. It combines two powerful monitoring systems into one comprehensive security solution that works with any WiFi adapter supporting monitor mode.
Key Features
๐ก๏ธ Deauth Attack Detection
Real-time detection of WiFi deauthentication attacks using advanced behavioral analysis
- Dual-band monitoring (2.4GHz & 5GHz)
- MAC spoofing detection
- Threat scoring (0-100 scale)
- Forensic logging for evidence
๐ก Network Device Monitor
Track all devices on your network with intelligent detection and alerting
- Real-time device tracking
- IoT device identification
- Suspicious device alerts
- Connection statistics & history
๐ง Behavioral Analysis
Advanced fingerprinting techniques that donโt rely on hardware MAC addresses
- Timing pattern analysis
- RSSI tracking & anomaly detection
- Sequence number verification
- Multi-factor legitimacy scoring
๐ Universal Compatibility
Works with any monitor mode capable WiFi adapter on Linux systems
- Tested on Raspberry Pi & Ubuntu
- Supports Atheros, Ralink, Realtek chipsets
- Run both tools simultaneously
- No specialized hardware required
How It Works
Instead of relying on hardware MAC addresses (which most adapters donโt expose), WiFi Security Monitor uses sophisticated behavioral fingerprinting:
- โฑ๏ธ Timing Analysis โ Legitimate routers have consistent timing patterns, while attack tools show irregular behavior
- ๐ถ RSSI Tracking โ Sudden signal strength changes indicate device switching or location spoofing
- ๐ข Sequence Numbers โ Duplicate or anomalous sequence numbers reveal packet injection attacks
- ๐ Rate Analysis โ Attack tools often use unusual transmission rates that differ from legitimate traffic
- โ Legitimacy Scoring โ Multi-factor assessment combines all metrics to determine if a device is genuine
Understanding Threat Levels
- ๐ข LOW (0-39) โ Likely legitimate activity - normal router behavior with no red flags
- ๐ก MEDIUM (40-69) โ Suspicious activity detected - monitor closely and investigate source
- ๐ด CRITICAL (70-100) โ Active attack detected - immediate action required to protect network
Technical Details
๐ป Requirements
- Python 3.7 or higher
- Linux OS (Raspberry Pi, Ubuntu, etc.)
- Monitor mode capable WiFi adapter
- Root/sudo access
- Scapy library
โ Tested Adapters
- Alfa AWUS036NHA (Atheros AR9271)
- Alfa AWUS036ACH (Realtek RTL8812AU)
- TP-Link TL-WN722N v1 (Atheros AR9271)
- Panda PAU09 (Ralink RT5372)
๐ฏ Use Cases
- Home network security
- Security research & testing
- IoT device management
- Network troubleshooting
- Penetration testing (authorized)
๐ฎ Future Plans
- Web dashboard interface
- Email/SMS notifications
- Machine learning detection
- Additional attack types
- Mobile app support
Quick Start
# Clone the repository
git clone https://github.com/nnxazolazuranikola/wifi-security-monitor.git
cd wifi-security-monitor
# Install dependencies
pip3 install -r requirements.txt
# Configure your settings
cp config.example.json config.json
nano config.json
# Enable monitor mode
sudo airmon-ng start wlan0
# Start deauth attack detector
sudo python3 deauth_detector.py
# In another terminal, start device monitor
sudo python3 network_monitor.py
โ ๏ธ Legal Disclaimer
This tool is for authorized security testing only. Only use it on networks you own or have explicit permission to test. Monitor mode may violate local regulations in some jurisdictions. Unauthorized network monitoring may be illegal in your country. The author assumes no liability for misuse.
Get Started
WiFi Security Monitor is open source and actively maintained. Check out the repository for complete documentation, examples, and community support.
๐ฆ GitHub Repository ยท ๐ Documentation ยท ๐ Release Blog Post