GhostESP: Revival

Note: this is a detached fork of Spooky's GhostESP which has been archived and not in development anymore.

⭐️ Enjoying GhostESP? Please give the repo a star!

GhostESP turns your ESP32 into a powerful, cheap and helpful wireless testing tool. Built on ESP-IDF.

---

Getting Started

1. Flash your device: flasher.ghostesp.net

2. Community & support: Discord

3. Learn more: Documentation • Official Website

Making content about GhostESP? Check out the Press Kit for resources.

---

Key Features

WiFi Features

• Evil Portal
• Deauth / disassoc attacks
• Karma
• Beacon spam (single/list/random)
• AP scan / STA scan / scanall
• Probe request listening
• Handshake + PMKID capture
• WiFi capture to SD (PCAP)
• USB dongle mode for Wireshark (extcap stream)
• DHCP starvation
• ARP / port / SSH / local IP scanners
• WiFi OUI vendor lookup
• WPA3/SAE attacks
• EAPOL logoff attack
• Wardriving exports (WiFi/BLE/GPS) + sweep CSV (WiFi/BLE/GPS/802.15.4)
• Split-channel wardriving helper via GhostLink
• RSSI tracking (AP/station)
• Drone detection / spoofing
• Web UI + filesystem + remote command relay

BLE Features

• BLE scan modes (general, AirTag, Flipper)
• BLE spam modes
• AirTag scan / spoof
• BLE packet capture
• BLE stream to Wireshark
• Flipper finder + RSSI
• GATT/service scan + per-device RSSI
• BLE wardriving
• BLE skimmer detection

USB Features

• USB keyboard host mode (ESP32-S3 builds)
• Remote keyboard control over GhostLink
• BadUSB script runner
• BadUSB identity options (VID/PID/manufacturer/product/layout/randomize)

IR Features

• IR TX/RX on supported boards
• IR learn mode
• IR easy learn mode
• Flipper .ir file support
• Universal library transmit
• IR CLI tools
• IR dazzler (38 kHz high duty)

NFC Features

• PN532 NTAG/MIFARE Classic support
• Flipper .nfc import/export
• MIFARE Classic dictionary attack
• Flipper NFC parser set (transit/parking/access)
• MIFARE Desfire detection
• Chameleon Ultra support (CLI + UI)

Additional Features

• GhostLink (dual-device command and display interface)
• Setup wizard (display builds)
• Wired + web screen mirroring
• Ethernet mode + fingerprint scan
• DIAL / Chromecast V2 support
• GPS integration (gpsinfo)
• Network printer output (powerprinter)
• RGB LED modes
• Timezone configuration (timezone)
• Rave mode (display builds)

ESP32 Firmware Comparison

---

Supported ESP32 Models

• ESP32 Wroom

• ESP32 S2

• ESP32 C3

• ESP32 S3

• ESP32 C5

• ESP32 C6

Note: Feature availability may vary by model.

---

Supported Boards

Supported Boards

• DevKitC-ESP32

• DevKitC-ESP32-S2 (lacks bluetooth hardware)

• DevKitC-ESP32-C3

• DevKitC-ESP32-S3

• DevKitC-ESP32-C5

• DevKitC-ESP32-C6

• RabbitLabs GhostBoard

• AWOK Mini

• M5 Cardputer

• M5 Cardputer ADV

• FlipperHub Rocket

• FlipperHub Pocker Marauder

• RabbitLabs Phantom

• RabbitLabs Yapper Board

• RabbitLabs Poltergeist

• CYD2432S028R

• Waveshare 7″ Touch

• 'CYD2 USB'

• 'CYD2 USB 2.4″'

• LilyGo T-Display S3 Touch

• LilyGo T-Deck

• JCMK Devboard Pro

• Flipper JCMK GPS

• CrowTech 7″

• JC3248W535EN

• Heltec V3

• Lolin S3 Pro

• Minion

• Sunton 7″

---

Credits

Special thanks to:

JustCallMeKoKo ESP32Marauder foundational development	thibauts CastV2 protocol insights	MarcoLucidi01 DIAL protocol integration	SpacehuhnTech Reference deauthentication code
Spooks4576 Original GhostESP Developer	Tototo31 Large contributions to the project	WillyJL Core Flipper Firmware functionality and BLE Spam code	Flipper Zero firmware Core IR & NFC implementation (flipperdevices/flipperzero-firmware & contributors)
Garag Core NFC library

Portions of the IR and NFC functionality are adapted from the open-source Flipper Zero firmware by flipperdevices and its community contributors.

---

Disclaimers

Ghost ESP is intended solely for educational and ethical security research. Unauthorized or malicious use is illegal. Be sure to familiarize your local laws, and always obtain proper permissions before conducting any network tests.

For guidelines on using the GhostESP name and logo, please see BRAND GUIDELINES.

Interested in becoming an official partner? Email partners@ghostesp.net.

---

Open Source Contributions

This project is open source and welcomes your contributions. If you've added new features or enhanced device support, please submit your changes!