147 lines
5.5 KiB
Markdown
147 lines
5.5 KiB
Markdown
# ESP32-C5 Unified Toolkit v2.0
|
|
|
|
A comprehensive WiFi and Bluetooth toolkit for ESP32-C5 featuring advanced scanning, packet analysis, signal intelligence, and network testing capabilities with a hacker-style web interface.
|
|
|
|
## Features
|
|
|
|
### Core Capabilities
|
|
- **WiFi Scanner**: Dual-band (2.4GHz + 5GHz) network discovery with real-time signal analysis
|
|
- **Packet Sniffer**: Advanced packet capture with filtering and real-time flow visualization
|
|
- **Deauth Engine**: Dual-band deauth attacks with simultaneous 2.4GHz + 5GHz targeting
|
|
- **Bluetooth Scanner**: BLE device discovery and analysis
|
|
- **Bluetooth Jamming**: Bluetooth interference capabilities (authorized use only!)
|
|
- **Signal Analysis**: Real-time signal strength tracking and channel utilization analysis
|
|
- **Channel Mapping**: Visual channel occupancy mapping for both bands
|
|
- **System Dashboard**: Advanced system monitoring with real-time statistics
|
|
|
|
### Advanced Features
|
|
- **Real-time Graphs**: Beautiful Chart.js visualizations for network activity, signal strength, packet flow, and channel utilization
|
|
- **Interactive Controls**: Advanced menus with real-time updates and terminal-style interface
|
|
- **Hacker Aesthetic UI**: Terminal/matrix-style interface with no emojis, professional hacker vibes
|
|
- **Signal Intelligence**: RSSI history tracking, channel utilization metrics, and signal analysis
|
|
- **Attack Automation**: Configurable attack parameters with real-time statistics
|
|
- **Multi-band Operations**: Simultaneous operations across 2.4GHz and 5GHz bands
|
|
|
|
## Hardware Requirements
|
|
|
|
- ESP32-C5 development board
|
|
- USB-C cable for programming and power
|
|
|
|
## Build Requirements
|
|
|
|
- ESP-IDF v5.4+ or master branch
|
|
- Python 3.6+
|
|
|
|
## Build Instructions
|
|
|
|
1. **Set up ESP-IDF environment:**
|
|
```bash
|
|
source $IDF_PATH/export.sh
|
|
```
|
|
|
|
2. **Set target to ESP32-C5:**
|
|
```bash
|
|
cd ESP32-C5-Toolkit
|
|
idf.py --preview set-target esp32c5
|
|
```
|
|
|
|
3. **Configure (optional):**
|
|
```bash
|
|
idf.py menuconfig
|
|
```
|
|
|
|
4. **Build:**
|
|
```bash
|
|
idf.py build
|
|
```
|
|
|
|
5. **Flash:**
|
|
```bash
|
|
idf.py -p [PORT] flash monitor
|
|
```
|
|
|
|
## Usage
|
|
|
|
1. Power on your ESP32-C5 device
|
|
2. Connect to the WiFi network:
|
|
- **SSID**: `ESP32-C5-Toolkit`
|
|
- **Password**: `h4ck3rm4n`
|
|
3. Open a web browser and navigate to `http://192.168.4.1`
|
|
4. Use the web interface to access all features
|
|
|
|
## Web Interface Pages
|
|
|
|
- **Dashboard**: System information, real-time statistics, and network activity graphs
|
|
- **WiFi Scanner**: Discover and analyze WiFi networks with signal strength distribution graphs
|
|
- **Packet Sniffer**: Capture and analyze WiFi packets with real-time packet flow visualization
|
|
- **Bluetooth Scanner**: Discover BLE devices and manage Bluetooth jamming operations
|
|
- **Deauth Engine**: Network testing tool with attack statistics and dual-band targeting
|
|
- **Signal Analysis**: Real-time signal strength over time and channel utilization analysis
|
|
- **Channel Map**: Visual channel occupancy mapping for 2.4GHz and 5GHz bands
|
|
- **System Config**: Device configuration, antenna selection, and system control
|
|
|
|
## ⚠️ Legal Notice
|
|
|
|
This toolkit is for **AUTHORIZED TESTING ONLY**. Use only on networks you own or have explicit permission to test. Unauthorized network access or interference may be illegal in your jurisdiction. You are responsible for your actions.
|
|
|
|
## Project Structure
|
|
|
|
```
|
|
ESP32-C5-Toolkit/
|
|
├── CMakeLists.txt # Root project configuration
|
|
├── main/
|
|
│ ├── CMakeLists.txt # Component configuration
|
|
│ ├── main.c # Application entry point
|
|
│ ├── board_config.h # Board-specific settings
|
|
│ ├── wifi_init.c/h # WiFi initialization with frame bypass
|
|
│ ├── wifi_scan.c/h # Unified WiFi scanning (dual-band)
|
|
│ ├── wifi_sniffer.c/h # Advanced packet sniffing
|
|
│ ├── deauth_engine.c/h # Dual-band deauth functionality
|
|
│ ├── bt_scanner.c/h # Bluetooth scanning and jamming
|
|
│ ├── signal_analysis.c/h # Signal analysis and channel utilization
|
|
│ └── web_server.c/h # Enhanced web interface with graphs
|
|
├── README.md
|
|
└── LICENSE
|
|
```
|
|
|
|
## Enhanced Features (v2.0)
|
|
|
|
### UI Enhancements
|
|
- Complete hacker aesthetic redesign with terminal/matrix styling
|
|
- Chart.js integration for beautiful real-time graphs
|
|
- Advanced interactive controls and menus
|
|
- Professional terminal-style interface (no emojis)
|
|
- Real-time data visualization and statistics
|
|
|
|
### New Capabilities
|
|
- **Bluetooth Scanning**: Discover and analyze BLE devices
|
|
- **Bluetooth Jamming**: Interference capabilities for authorized testing
|
|
- **Signal Analysis**: RSSI history tracking and channel utilization
|
|
- **Channel Mapping**: Visual representation of channel occupancy
|
|
- **Advanced Graphs**: Network activity, signal strength, packet flow, channel utilization
|
|
- **Real-time Updates**: Live statistics and monitoring
|
|
|
|
### Technical Improvements
|
|
- Signal analysis integration with packet sniffer
|
|
- Channel utilization tracking
|
|
- Enhanced API endpoints for all features
|
|
- Improved error handling and logging
|
|
- Optimized memory usage
|
|
|
|
## Credits
|
|
|
|
This project combines and enhances features from:
|
|
- ESP32-C5-J4CK3D (packet sniffing, web interface foundation)
|
|
- esp32-c5-dualband-deauther (deauth engine)
|
|
- ESP32-C5-WiFi-Scanner (scanning approach)
|
|
|
|
Enhanced with:
|
|
- Advanced UI/UX design
|
|
- Bluetooth capabilities
|
|
- Signal analysis features
|
|
- Real-time graph visualizations
|
|
|
|
## License
|
|
|
|
See LICENSE file for details.
|