ESP32 DIV
ESP32DIV is a multi-purpose wireless offensive and defensive toolkit powered by an ESP32
Complete project story, in-depth tutorials, and all the features in [Wiki](https://github.com/cifertech/ESP32-DIV/wiki)! From Wi-Fi deauthentication attacks to Sub-GHz signal replay, the Wiki covers everything you need to get started. [Click here to explore now!](https://github.com/cifertech/ESP32-DIV/wiki) The project is written primarily in C++, distributed under the MIT License license, first published in 2023. It has gained significant community traction with 3,174 stars and 423 forks on GitHub. Key topics include: arduino, attack, bluetooth, deauthentication-attack, deauther.
📖 Explore the ESP32-DIV Wiki
Complete project story, in-depth tutorials, and all the features in Wiki! From Wi-Fi deauthentication attacks to Sub-GHz signal replay, the Wiki covers everything you need to get started. Click here to explore now!
<div> </div> <!-- About the Project -->⚡ Skip the IDE — flash directly from your browser at cifertech.github.io/ESP32-DIV
:star2: About the Project
ESP32-DIV is an open-source, multi-band wireless toolkit built on the ESP32-S3. It covers Wi-Fi, BLE, 2.4GHz, Sub-GHz, IR, RFID/NFC, and GPS. all from a compact handheld device with a touchscreen UI. Whether you're analyzing wireless traffic, testing signal resilience, or building your own RF tools, ESP32-DIV gives you a single platform to do it all.
<!-- Features -->[!WARNING]
This project is intended for educational and research purposes only. Use only on networks and devices you own or have explicit permission to test. Unauthorized use may violate local laws.
:dart: Features
<details> <summary><strong>📡 Wi-Fi</strong></summary>| Tool | Description |
|---|---|
| Packet Monitor | Real-time waterfall graph across all 14 channels; optional PCAP logging to SD |
| Wi-Fi Scanner | Lists nearby networks with extended details |
| Beacon Spammer | Broadcasts fake SSIDs (custom or random) |
| Deauth Attack | Sends deauthentication frames to disrupt client connections |
| Deauth Detector | Monitors for incoming deauth attacks |
| Captive Portal | AP + DNS + web server; clone networks and force sign-in pages |
| Probe Flood | Floods probe requests to stress-test APs |
| Tool | Description |
|---|---|
| BLE Scanner | Discovers hidden and visible BLE devices |
| BLE Sniffer | Tracks MAC, RSSI, packet count, and last-seen time |
| BLE Spoofer | Broadcasts fake BLE advertisements |
| Sour Apple | Spoof Apple BLE advertisements (e.g., AirDrop popups) |
| BLE Jammer | Disrupts BLE and classic Bluetooth channels |
| BLE Rubber Ducky | Acts as a BLE keyboard; executes scripts from /ducky on SD |
| Tool | Description |
|---|---|
| 2.4GHz Scanner | Spectrum analyzer across 128 channels (Zigbee, custom RF, etc.) |
| Protokill | Disrupts Zigbee, Wi-Fi, and other 2.4GHz protocols |
| Tool | Description |
|---|---|
| Replay Attack | Captures and replays Sub-GHz commands (e.g., garage doors, remotes) |
| Sub-GHz Jammer | Disrupts Sub-GHz communication across various bands |
| Saved Profiles | Stores and manages captured signal profiles |
| Tool | Description |
|---|---|
| IR Replay Attack | Captures real IR presses, visualizes, replays, and saves to SD |
| IR Saved Profiles | Browses IR captures; preserves signal and carrier frequency |
| Universal IR Controller | Built-in profiles, SD imports, favorites, and remote-style control |
| Tool | Description |
|---|---|
| Card Reader | Reads UID and tag identification |
| Card Clone | Copies supported writable tags |
| Dump | Reads sectors/blocks when keys are available |
| Decode Access | Interprets access bits and ACL-style fields from dumps |
| Erase | Wipes supported writable tags |
| Jam Reader | Impedes another reader with RF patterns |
| Tag Disrupt | Advanced disruption flows for authorized physical tests |
| Disrupt Emulate | Disruption combined with emulation-style flows |
| Tool | Description |
|---|---|
| Wardriver | Logs GNSS position with Wi-Fi/BLE observations to SD |
| Satellite Scanner | Shows satellites in view, signal strength, and fix diagnostics |
| Tool | Description |
|---|---|
| Serial Monitor | Mirrors serial traffic on the TFT for field debugging |
| SD File Manager | Browses and manages files on the SD card |
| Update Firmware | Flashes new firmware from SD |
| Touch Calibrate | Four-corner XPT2046 touchscreen calibration |
| Settings | Brightness, dark/light theme, NeoPixel, background auto-scan |
🔧 Hardware Overview
ESP32DIV consists of two boards:
🧠 Main Board
- ESP32-S3 – Main microcontroller with Wi-Fi and BLE
- ILI9341 TFT Display – 2.8" UI display
- LF33 – 3.3V regulator
- IP5306 – Lithium battery charging and protection
- CP2102 – USB to serial for flashing
- PCF8574 – I/O expander for buttons
- SD Card Slot – Stores logs and captured signals
- Push Buttons – Navigation and interaction
- Antenna Connector – External antenna support
- WS2812 NeoPixels - Giving better feedback
- Buzzer - It shares a GPIO with the battery voltage divider, so using it is optional.
🛡️ Shield
- 3x NRF24 Modules – 2.4GHz jamming and spoofing
- 1x CC1101 Module – Sub-GHz jamming and replay
- Multiple antennas - Extended range
- IR Transceiver - Capture & replay IR remotes
:warning: License
Distributed under the MIT License. See LICENSE.txt for more information.
<!-- Support & Contributions -->💬 Support & Contributions
- 💬 Found a bug or have a feature request? Open an Issue
- ⭐ Like the project? Star the repo!
- 🛠 Want to contribute? Fork it and submit a pull request.
:handshake: Contact
▶ Support me on Patreon patreon.com/cifertech
CiferTech - @twitter - CiferTech@gmali.com
Project Link: https://github.com/cifertech/ESP32-DIV
Contributors
Showing top 3 contributors by commit count.
Related Repositories
arendst/Tasmota
Alternative firmware for ESP8266 and ESP32 based devices with easy configuration using webUI, OTA updates, automation using timers or rules, expandability and entirely local control over MQTT, HTTP, Serial or KNX. Full documentation at
tinygo-org/tinygo
Go compiler for small places. Microcontrollers, WebAssembly (WASM/WASI), and command-line tools. Based on LLVM.
MarlinFirmware/Marlin
Marlin is a firmware for RepRap 3D printers optimized for both 8 and 32 bit microcontrollers. Marlin supports all common platforms. Many commercial 3D printers come with Marlin installed. Check with your vendor if you need source code for your specific machine.
espressif/arduino-esp32
Arduino core for the ESP32 family of SoCs
SpacehuhnTech/esp8266_deauther
Affordable WiFi hacking platform for testing and learning
arduino/Arduino
Arduino IDE 1.x