https://github.com/spooks4576/ghost_esp
Ghost ESP is a ESP32 Firmware that Revolutionizes the way we use ESP32 devices in a Pen Testing aspect
https://github.com/spooks4576/ghost_esp
esp32 esp32-c3 esp32-c6 esp32-wroom esp32s2 flipperzero wifi-dev-board
Last synced: 9 months ago
JSON representation
Ghost ESP is a ESP32 Firmware that Revolutionizes the way we use ESP32 devices in a Pen Testing aspect
- Host: GitHub
- URL: https://github.com/spooks4576/ghost_esp
- Owner: Spooks4576
- License: mit
- Created: 2024-03-15T13:43:31.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2025-04-01T17:35:00.000Z (9 months ago)
- Last Synced: 2025-04-13T02:12:43.744Z (9 months ago)
- Topics: esp32, esp32-c3, esp32-c6, esp32-wroom, esp32s2, flipperzero, wifi-dev-board
- Language: C
- Homepage: https://ghostesp.net/
- Size: 137 MB
- Stars: 934
- Watchers: 33
- Forks: 142
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Ghost ESP: Next Generation Wi-Fi Pentesting
**⭐️ Enjoying Ghost ESP? Please give our repo a star!**
Ghost ESP turns your ESP32 into a powerful, cheap and helpful wireless testing tool. Built on ESP-IDF.
> **Note:** This is an **Alpha release**. Some features are still under development and may be unstable.
---
## Getting Started
1. Follow our [Flashing Guide](https://github.com/Spooks4576/Ghost_ESP/wiki) for installation and configuration.
2. Join our community on [Discord](https://discord.gg/PkdjxqYKe4) for support and feedback.
3. Visit our [Official Website](https://ghostesp.net) to stay in touch!
---
## Key Features
WiFi Features
- **AP Scanning** – Detect nearby WiFi networks.
- **Station Scanning** – Monitor connected WiFi clients.
- **Beacon Spam** – Broadcast customizable SSID beacons.
- **Deauthentication Attacks** – Disconnect clients from specific networks.
- **WiFi Capture** – Log probe requests, beacon frames, deauth packets, and raw data *(requires SD card or compatible storage)*.
- **Evil Portal** – Set up a fake WiFi portal with a custom SSID and domain.
- **Pineapple Detection** – Detect Wi-Fi Pineapples and Evil Twin Attacks.
- **Web-UI** – Built-in interface for changing settings and sending commands easily.
- **Port Scanning** – Scan your local network for open ports.
BLE Features
- **BLE Scanning** – Detect BLE devices, including specialized modes for AirTags, Flipper Zeros, and more.
- **BLE Packet Capture** – Capture and analyze BLE traffic.
- **BLE Wardriving** – Map and track BLE devices in your vicinity.
Additional Features
- **GPS Integration** – Retrieve location info via the `gpsinfo` command *(on supported hardware)*.
- **RGB LED Modes** – Customizable LED feedback (Stealth, Normal, Rainbow).
- **DIAL & Chromecast V2 Support** – Interact with DIAL-capable devices (e.g., Roku, Chromecast).
- **Flappy Ghost and Rave Modes** – Extra apps for boards with displays.
> **Note:** BLE Spam is **NOT** supported at this time.
---
## Supported ESP32 Models
- **ESP32 Wroom**
- **ESP32 S2**
- **ESP32 C3**
- **ESP32 S3**
- **ESP32 C6**
> **Note:** Feature availability may vary by model.
> We do NOT support BLE Spam
---
## Ghost ESP vs. ESP32 Marauder
---
## Acknowledgments
Special thanks to:
- **[JustCallMeKoKo](https://github.com/justcallmekoko/ESP32Marauder):** For foundational ESP32 development.
- **[thibauts](https://github.com/thibauts/node-castv2-client):** For CastV2 protocol insights.
- **[MarcoLucidi01](https://github.com/MarcoLucidi01/ytcast/tree/master/dial):** For DIAL protocol integration.
- **[SpacehuhnTech](https://github.com/SpacehuhnTech/esp8266_deauther):** For reference deauthentication code.
---
## Legal Disclaimer
Ghost ESP is intended solely for educational and ethical security research. Unauthorized or malicious use is illegal. Always obtain proper permissions before conducting any network tests.
---
## 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!