c5-project/ESP32-C5-Toolkit/README.md

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:

   source $IDF_PATH/export.sh
   

2. Set target to ESP32-C5:

   cd ESP32-C5-Toolkit
   idf.py --preview set-target esp32c5
   

3. Configure (optional):

   idf.py menuconfig
   

4. Build:

   idf.py build
   

5. Flash:

   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.