# 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.