ESP32-DIV - ESP32DIV is a multi-purpose wireless offensive and

项目说明

<di="center">

<img src=" alt="ESP32-DI" width="100%"/>

<br/>
<br/>

<p align="center">
<a href=" src="
<a href=" src="
<a href=" src="
<img src="
<img src="
<img src="
</p>

<p align="center">
<a href=" src="
<a href=" src="
<a href=" src="
<a href=" src="
</p>

</div>

&nbsp;

📖 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 e you need to get started. Click here to explore now!

> ⚡ Skip the IDE — flash directly from your browser at cifertech.github.io/ESP32-DIV

<div>&nbsp;</div>

<!-- About the Project -->

:star2: About the Project

ESP32-DIV is an open-源码, 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-DI you a single platform to do it all.

> [!WARNING]
> This project is intended for educational and research purposes only. Use only on networks and devices you own or ha permission to test. Unauthorized use may local laws.

<!-- Features -->

: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 客户端 connections |
| Deauth Detector | Monitors for incoming deauth attacks |
| Capti | AP + DNS + web 服务端; clone networks and force sign-in pages |
| Probe Flood | Floods probe requests to stress-test APs |
| Hidden SSID Re | Forces hidden networks to expose their SSID |
| WPS Scanner | Detects access points with WPS enabled |
| ARP Scanner | Maps all devices on a 网络 with IP and MAC after joining |
| Karma Attack | Listens for probe requests and impersonates sa to auto-connect devices |

</details>
<details>
<summary><strong>🔵 Bluetooth</strong></summary>

| Tool | Description |
|------|-------------|
| BLE Scanner | Discovers hidden and BLE devices |
| BLE Sniffer | Tracks MAC, RSSI, packet count, and last-seen time |
| BLE Spoofer | Broadcasts fake BLE ad |
| Sour Apple | Spoof Apple BLE ad (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 |
| AirTag Spoofer | Broadcasts fake AirTag signals into the Find My 网络 |
| AirTag Sniffer | Monitors for AirTags in range |
| Skimmer Detect | Scans for BLE signatures matching known card skimmer profiles |

</details>
<details>
<summary><strong>📶 2.4GHz / NRF24</strong></summary>

| Tool | Description |
|------|-------------|
| 2.4GHz Scanner | Spectrum analyzer across 128 channels (Zigbee, custom RF, etc.) |
| Protokill | Disrupts Zigbee, Wi-Fi, and other 2.4GHz protocols |
| ESB Sniffer | Passively captures Enhanced ShockBurst NRF24 packets |
| ESB Replay | Replays captured ESB packets |
| MouseJack Scan | Detects wireless mice and keyboards |
| MouseJack Inject | Injects keystrokes into wireless receivers |

</details>
<details>
<summary><strong>📻 Sub-GHz</strong></summary>

| Tool | Description |
|------|-------------|
| Replay Attack | Captures and replays Sub-GHz commands (e.g., garage doors, remotes) |
| Sub-GHz Jammer | Disrupts Sub-GHz communication across bands |
| Sa | Stores and manages captured signal profiles |
| De Bruijn / Brute Force | Cycles through all possible fixed codes for Sub-GHz remotes |
| Jamming Detector | Recei monitor that detects Sub-GHz jamming attacks (e.g. car-fob jamming) |

</details>
<details>
<summary><strong>📺 Infrared (IR)</strong></summary>

| Tool | Description |
|------|-------------|
| IR Replay Attack | Captures real IR presses, , replays, and saves to SD |
| IR Sa | Browses IR captures; preser and carrier frequency |
| Uni IR Controller | Built-in profiles, SD imports, fa, and remote-style control |

</details>
<details>
<summary><strong>🧲 RFID / NFC</strong></summary>

| Tool | Description |
|------|-------------|
| Card Reader | Reads UID and tag identification |
| Card Clone | Copies supported writable tags |
| Dump | Reads sectors/blocks when keys are a |
| 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 | Ad disruption flows for authorized physical tests |
| Disrupt Emulate | Disruption combined with emulation-style flows |

</details>
<details>
<summary><strong>🛰️ GPS</strong></summary>

| Tool | Description |
|------|-------------|
| Wardriver | Logs GNSS position with Wi-Fi/BLE obser to SD |
| Satellite Scanner | Shows satellites in view, signal strength, and fix diagnostics |

</details>
<details>
<summary><strong>🧰 Device & System</strong></summary>

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

</details>

<div>&nbsp;</div>

<!-- ESP32-DIV -->
<table>
<tr>
<td style="text-align: center;">
<img src=" alt="ESP32-DIV Beta" style="width: 1920px; border: 1px solid #ccc; border-radius: 5px;">
<p style="font-style: italic; font-size: 14px; margin-top: 5px;">ESP32-DIV v2</p>
</td>
</tr>
</table>

<table>
<tr>
<td style="text-align: center;">
<img src=" alt="ESP32-DIV Beta" style="width: 600px; border: 1px solid #ccc; border-radius: 5px;">
<p style="font-style: italic; font-size: 14px; margin-top: 5px;">ESP32-DIV Beta</p>
</td>
<td style="text-align: center;">
<img src=" alt="ESP32-DIV v1" style="width: 600px; border: 1px solid #ccc; border-radius: 5px;">
<p style="font-style: italic; font-size: 14px; margin-top: 5px;">ESP32-DIV v1</p>
</td>
</tr>
</table>

<div>&nbsp;</div>

<!-- Hardware O -->

🔧 Hardware O

ESP32DI of two boards:

🧠 Main Board

ESP32-S3 – Main microcontroller with Wi-Fi and BLE

ILI9341 TFT Display – 2.8" UI display

LF33 – 3.3

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 – Na and interaction

Antenna Connector – External antenna support

WS2812 NeoPixels - Giving better feedback

Buzzer - It shares a GPIO with the battery 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

<div>&nbsp;</div>

<table>
<tr>
<td style="text-align: center;">
<img src=" alt="ESP32-DIV Beta" style="width: 600px; border: 1px solid #ccc; border-radius: 5px;">
<p style="font-style: italic; font-size: 14px; margin-top: 5px;">ESP32-DIV v2 Main Board</p>
</td>
<td style="text-align: center;">
<img src=" alt="ESP32-DIV v1" style="width: 600px; border: 1px solid #ccc; border-radius: 5px;">
<p style="font-style: italic; font-size: 14px; margin-top: 5px;">ESP32-DIV v2 Shield</p>
</td>
</tr>
</table>

<table>
<tr>
<td style="text-align: center;">
<img src=" alt="ESP32-DIV Beta" style="width: 600px; border: 1px solid #ccc; border-radius: 5px;">
<p style="font-style: italic; font-size: 14px; margin-top: 5px;">ESP32-DIV v1 Main Board</p>
</td>
<td style="text-align: center;">
<img src=" alt="ESP32-DIV v1" style="width: 600px; border: 1px solid #ccc; border-radius: 5px;">
<p style="font-style: italic; font-size: 14px; margin-top: 5px;">ESP32-DIV v1 Shield</p>
</td>
</tr>
</table>

<div>&nbsp;</div>

<!-- License -->

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

‎

<!-- Contact -->

Contact

Support me on Patreon patreon.com/cifertech

CiferTech - @X -

Project Link:

项目信息

开发语言：C++

Star 数：4132

技术要点

该项目属于安全软件方向的开源资源，代码结构清晰，适合安全研究人员学习参考。项目围绕ESP32DIV is a multi-purpose wireless offensive and defensive toolkit powered by an ESP32展开，提供了可运行的实现，对理解相关安全机制、工具原理与攻防技术具有较高的研究价值。

从技术实现角度看，此类项目的核心在于对底层原理的深入理解与工程化落地。开发者在研究过程中可以结合官方文档与社区讨论，梳理项目的初始化流程、核心模块职责与数据流转，逐步掌握其中的技术细节与设计思路。

使用与学习建议

1. 下载源码压缩包，解压到本地环境。

2. 根据项目类型准备对应的运行环境与依赖。

3. 按照 README 中的步骤完成配置与部署。

4. 在隔离的测试环境中运行验证，避免影响生产系统。

免责声明

本资源来源于开源社区，仅供安全研究、技术学习与合法授权范围内的攻防演练使用，请勿用于任何非法或侵害他人权益的用途。使用本项目产生的一切后果由使用者自行承担。