ESP32DIV ist ein multifunktionales drahtloses Offensiv- und Defensiv-Toolkit, das auf einem ESP32 basiert.
<div align="center">
<img src="https://github.com/user-attachments/assets/1f70e8ba-d8be-4889-959a-700294068a3e" alt="ESP32-DIV Banner" width="100%"/>
<br/>
<br/>
<p align="center">
<a href="https://github.com/cifertech/ESP32-DIV"><img src="https://img.shields.io/static/v1?label=cifertech&message=ESP32-DIV&color=orange&logo=github"/></a>
<a href="https://github.com/cifertech/ESP32-DIV"><img src="https://img.shields.io/github/stars/cifertech/ESP32-DIV?style=social"/></a>
<a href="https://github.com/cifertech/ESP32-DIV"><img src="https://img.shields.io/github/forks/cifertech/ESP32-DIV?style=social"/></a>
<img src="https://img.shields.io/github/downloads/cifertech/esp32-div/total?color=orange&label=downloads&logo=github"/>
<img src="https://img.shields.io/badge/ESP32-Offensive%20+%20Defensive-orange?logo=espressif"/>
<img src="https://img.shields.io/badge/license-MIT-orange"/>
</p>
<p align="center">
<a href="https://twitter.com/techcifer"><img src="https://img.shields.io/badge/Twitter-orange?logo=x&logoColor=black"/></a>
<a href="https://www.instagram.com/cifertech/"><img src="https://img.shields.io/badge/Instagram-orange?logo=instagram&logoColor=black"/></a>
<a href="https://www.youtube.com/c/techcifer"><img src="https://img.shields.io/badge/YouTube-orange?logo=youtube&logoColor=black"/></a>
<a href="https://cifertech.net/"><img src="https://img.shields.io/badge/Website-orange?logo=googlechrome&logoColor=black"/></a>
</p>
</div>
## 📖 Entdecke das ESP32-DIV-Wiki
Die komplette Projektgeschichte, ausführliche Tutorials und alle Funktionen findest du im [Wiki](https://github.com/cifertech/ESP32-DIV/wiki)! Von Wi-Fi-Deauthentifizierungsangriffen bis zum Sub-GHz-Signal-Replay – das Wiki deckt alles ab, was du für den Einstieg brauchst. [Klicke hier, um es jetzt zu entdecken!](https://github.com/cifertech/ESP32-DIV/wiki)
> ⚡ **Überspringe die IDE** — flashe direkt aus deinem Browser unter [cifertech.github.io/ESP32-DIV](https://cifertech.github.io/ESP32-DIV)
<div> </div>
<!-- About the Project -->
## :star2: Über das Projekt
ESP32-DIV ist ein Open-Source-Multiband-Funk-Toolkit auf Basis des **ESP32-S3**. Es deckt Wi-Fi, BLE, 2.4GHz, Sub-GHz, IR, RFID/NFC und GPS ab. All das von einem kompakten Handgerät mit Touchscreen-UI. Egal, ob du drahtlosen Datenverkehr analysierst, die Signalrobustheit testest oder deine eigenen HF-Werkzeuge baust – ESP32-DIV bietet dir eine einzige Plattform für alles.
> [!WARNING]
> Dieses Projekt ist ausschließlich für **Bildungs- und Forschungszwecke** gedacht. Verwende es nur in Netzwerken und auf Geräten, die dir gehören oder für die du eine ausdrückliche Testgenehmigung hast. Unbefugte Nutzung kann gegen lokale Gesetze verstoßen.
<!-- Features -->
## :dart: Funktionen
<details>
<summary><strong>📡 Wi-Fi</strong></summary>
| Tool | Beschreibung |
|------|-------------|
| Packet Monitor | Echtzeit-Wasserfalldiagramm über alle 14 Kanäle; optionales PCAP-Logging auf SD |
| Wi-Fi Scanner | Listet nahegelegene Netzwerke mit erweiterten Details auf |
| Beacon Spammer | Sendet gefälschte SSIDs (benutzerdefiniert oder zufällig) |
| Deauth Attack | Sendet Deauthentifizierungs-Frames, um Client-Verbindungen zu stören |
| Deauth Detector | Überwacht auf eingehende Deauth-Angriffe |
| Captive Portal | AP + DNS + Webserver; Netzwerke klonen und Anmeldeseiten erzwingen |
| Probe Flood | Überflutet Probe Requests, um Access Points unter Stress zu testen |
| Hidden SSID Revealer | Zwingt versteckte Netzwerke, ihre SSID preiszugeben |
| WPS Scanner | Erkennt Access Points mit aktiviertem WPS |
| ARP Scanner | Kartiert nach dem Beitritt alle Geräte in einem Netzwerk mit IP und MAC |
| Karma Attack | Lauscht auf Probe Requests und gibt sich als gespeicherte Netzwerke aus, um Geräte automatisch zu verbinden |
</details>
<details>
<summary><strong>🔵 Bluetooth</strong></summary>
| Tool | Beschreibung |
|------|-------------|
| BLE Scanner | Findet versteckte und sichtbare BLE-Geräte |
| BLE Sniffer | Verfolgt MAC, RSSI, Paketanzahl und Zeitpunkt der letzten Sichtung |
| BLE Spoofer | Sendet gefälschte BLE-Werbesignale |
| Sour Apple | Fälscht Apple-BLE-Werbesignale (z. B. AirDrop-Pop-ups) |
| BLE Jammer | Stört BLE- und klassische Bluetooth-Kanäle |
| BLE Rubber Ducky | Fungiert als BLE-Tastatur; führt Skripte von `/ducky` auf der SD aus |
| AirTag Spoofer | Sendet gefälschte AirTag-Signale in das Find-My-Netzwerk |
| AirTag Sniffer | Überwacht auf AirTags in Reichweite |
| Skimmer Detect | Scannt nach BLE-Signaturen, die bekannten Karten-Skimmer-Profilen entsprechen |
</details>
<details>
<summary><strong>📶 2.4GHz / NRF24</strong></summary>
| Tool | Beschreibung |
|------|-------------|
| 2.4GHz Scanner | Spektrumanalysator über 128 Kanäle (Zigbee, kundenspezifisches RF usw.) |
| Protokill | Stört Zigbee, Wi-Fi und andere 2.4GHz-Protokolle |
| ESB Sniffer | Erfasst passiv Enhanced-ShockBurst-NRF24-Pakete |
| ESB Replay | Spielt erfasste ESB-Pakete erneut ab |
| MouseJack Scan | Erkennt verwundbare Funkmäuse und -tastaturen |
| MouseJack Inject | Injiziert Tastatureingaben in verwundbare Funkempfänger |
</details>
<details>
<summary><strong>📻 Sub-GHz</strong></summary>
| Tool | Beschreibung |
|------|-------------|
| Replay Attack | Erfasst und spielt Sub-GHz-Befehle erneut ab (z. B. Garagentore, Fernbedienungen) |
| Sub-GHz Jammer | Stört die Sub-GHz-Kommunikation über verschiedene Bänder |
| Saved Profiles | Speichert und verwaltet erfasste Signalprofile |
| De Bruijn / Brute Force | Durchläuft alle möglichen festen Codes für Sub-GHz-Fernbedienungen |
| Jamming Detector | Nur-Empfangs-Monitor, der Sub-GHz-Störangriffe erkennt (z. B. Störung von Fahrzeugschlüsseln) |
</details>
<details>
<summary><strong>📺 Infrarot (IR)</strong></summary>
| Tool | Beschreibung |
|------|-------------|
| IR Replay Attack | Erfasst echte IR-Tastendrücke, visualisiert sie, spielt sie erneut ab und speichert sie auf der SD |
| IR Saved Profiles | Durchsucht IR-Aufnahmen; erhält Signal und Trägerfrequenz |
| Universal IR Controller | Integrierte Profile, SD-Importe, Favoriten und Steuerung im Fernbedienungsstil |
</details>
<details>
<summary><strong>🧲 RFID / NFC</strong></summary>
| Tool | Beschreibung |
|------|-------------|
| Card Reader | Liest UID und Tag-Identifikation |
| Card Clone | Kopiert unterstützte beschreibbare Tags |
| Dump | Liest Sektoren/Blöcke, wenn Schlüssel verfügbar sind |
| Decode Access | Interpretiert Zugriffsbits und ACL-artige Felder aus Dumps |
| Erase | Löscht unterstützte beschreibbare Tags |
| Jam Reader | Behindert ein anderes Lesegerät mit HF-Mustern |
| Tag Disrupt | Fortgeschrittene Störabläufe für autorisierte physische Tests |
| Disrupt Emulate | Störung kombiniert mit emulationsartigen Abläufen |
</details>
<details>
<summary><strong>🛰️ GPS</strong></summary>
| Tool | Beschreibung |
|------|-------------|
| Wardriver | Protokolliert GNSS-Position zusammen mit Wi-Fi/BLE-Beobachtungen auf der SD |
| Satellite Scanner | Zeigt sichtbare Satelliten, Signalstärke und Fix-Diagnose an |
</details>
<details>
<summary><strong>🧰 Gerät & System</strong></summary>
| Tool | Beschreibung |
|------|-------------|
| Serial Monitor | Spiegelt seriellen Datenverkehr auf dem TFT für Debugging vor Ort |
| SD File Manager | Durchsucht und verwaltet Dateien auf der SD-Karte |
| Update Firmware | Flasht neue Firmware von der SD-Karte |
| Touch Calibrate | XPT2046-Touchscreen-Kalibrierung über vier Ecken |
| Settings | Helligkeit, dunkles/helles Design, NeoPixel, Hintergrund-Autoscan |
</details>
<div> </div>
<!-- ESP32-DIV -->
<table>
<tr>
<td style="text-align: center;">
<img src="https://github.com/user-attachments/assets/52e5be67-9dc7-4b08-bd2a-0a4e4235cf9d" 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="https://github.com/user-attachments/assets/466ffd1b-9807-47ce-b221-5a6bffc1aa7d" 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="https://github.com/user-attachments/assets/fd8ba7d9-0409-4180-af42-a3e6e82b29b3" 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> </div>
<!-- Hardware Overview -->
## 🔧 Hardware-Übersicht
ESP32-DIV besteht aus zwei Platinen:
### 🧠 Hauptplatine
- **ESP32-S3** – Hauptmikrocontroller mit Wi-Fi und BLE
- **ILI9341-TFT-Display** – 2.8-Zoll-UI-Display
- **LF33** – 3.3V-Regler
- **IP5306** – Laden und Schutz des Lithium-Akkus
- **CP2102** – USB-zu-Seriell zum Flashen
- **PCF8574** – I/O-Expander für Tasten
- **SD-Kartensteckplatz** – Speichert Protokolle und erfasste Signale
- **Drucktasten** – Navigation und Interaktion
- **Antennenanschluss** – Unterstützung für externe Antennen
- **WS2812-NeoPixel** - Besseres Feedback
- **Buzzer** - Er teilt sich einen GPIO mit dem Batterie-Spannungsteiler, seine Verwendung ist daher optional.
### 🛡️ Shield
- **3x NRF24-Module** – 2.4GHz-Störung und Spoofing
- **1x CC1101-Modul** – Sub-GHz-Störung und Replay
- **Mehrere Antennen** - Erweiterte Reichweite
- **IR-Transceiver** - Erfassen und Wiedergeben von IR-Fernbedienungen
<div> </div>
<table>
<tr>
<td style="text-align: center;">
<img src="https://github.com/user-attachments/assets/0aeca1bb-9023-43a0-9f62-f89ced53098f" 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 Hauptplatine</p>
</td>
<td style="text-align: center;">
<img src="https://github.com/user-attachments/assets/bbfa2c55-02e0-4795-b003-fde06f2d64d9" 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="https://github.com/user-attachments/assets/b4e3ad5e-4f43-4c08-ae33-d713be0a3855" 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 Hauptplatine</p>
</td>
<td style="text-align: center;">
<img src="https://github.com/user-attachments/assets/21f10c62-5e6c-4565-8b86-7b89e24680c3" 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>
<!-- License -->
## :warning: Lizenz
Verteilt unter der MIT-Lizenz. Weitere Informationen findest du in LICENSE.txt.
<!-- Support & Contributions -->
## 💬 Support & Beiträge
- 💬 Einen Fehler gefunden oder eine Funktionsanfrage? Öffne ein [Issue](https://github.com/cifertech/ESP32-DIV/issues)
- ⭐ Gefällt dir das Projekt? Gib dem Repo einen Stern!
- 🛠 Möchtest du beitragen? Forke es und reiche einen Pull Request ein.
<!-- Contact -->
## :handshake: Kontakt
▶ Unterstütze mich auf Patreon [patreon.com/cifertech](https://www.patreon.com/cifertech)
CiferTech - [@twitter](https://twitter.com/techcifer) - [email protected]
Projektlink: [https://github.com/cifertech/ESP32-DIV](https://github.com/cifertech/ESP32-DIV)