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 for installation and configuration.
2. Join our community on Discord for support and feedback.
3. Visit our Official Website 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: For foundational ESP32 development.
• thibauts: For CastV2 protocol insights.
• MarcoLucidi01: For DIAL protocol integration.
• SpacehuhnTech: 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!