The project's README from github.com/geo-tp/ESP32-Bit-Pirate. As one markdown file: README.md.
ESP32 Bit Pirate is open-source firmware that turns your device into a multi-protocol development and analysis tool, inspired by the legendary Bus Pirate.
It supports sniffing, sending, scripting, and interacting with various digital protocols (I2C, UART, 1-Wire, SPI, etc.) via a serial terminal or web-based CLI. It also communicates with radio protocols like Bluetooth, Wi-Fi, Sub-GHz, LoRa and RFID.
The official project website centralizes everything: ESP32 Bit Pirate Website.
From there you can install the firmware, open the web tools, follow hardware guides, explore recipes, and access the documentation.
Interactive command-line interface (CLI) via USB Serial or WiFi Web.
Modes for:
Protocol sniffers I2C, UART, SPI, 1Wire, 2wire, CAN, Wi-Fi, Bluetooth, SubGhz.
Baudrate auto-detection, AT commands and various tools for UART.
Registers manipulation, EEPROM dump tools, identify devices for I2C.
Read all sort of EEPROM, Flash and various others tools for SPI.
Scripting using Bus Pirate-style bytecode instructions or Python.
Infrared support with more than 80 protocols.
Direct I/O management, PWM, servo, GPIOs state.
Analyze radio signals and frequencies on every bands.
Near than 50 addressable LEDs protocols supported.
Pirate assistant to help you with the firmware.
USB-Uart dongle, SPI programmer, logic analyzer, ESP-SDR and more.
Web Serial tools to use USB Serial over a web browser.
All boards listed below offer the exact same Bit Pirate features, with no differences in functionality or development status. Some features may require additional hardware.
| Device | Description | |
|---|---|---|
| ESP32 S3 Dev Kit (N8, N8R2, N8R8, N16R8...) | ![]() |
More than 20 available GPIO, 1 button |
| ESP32 S3 Zero / Super Mini | ![]() |
15 GPIO (exposed pins), 1 button |
| M5 AtomS3 Lite | ![]() |
8 GPIO (Grove, Header), IR TX, 1 buttton |
| M5 Cardputer | ![]() |
2 GPIO (Grove), screen, keyboard, mic, speaker, IR TX, SD card, battery, standalone mode |
| M5 Cardputer ADV | ![]() |
12 GPIO (Grove, Header), screen, keyboard, mic, speaker, IR TX, SD card, IMU, battery, Lora, CC1101, standalone mode |
| M5 StampS3 | ![]() |
9 GPIO (exposed pins), 1 button |
| M5 Stick S3 | ![]() |
13 GPIO (Grove, Header), screen, mic, speaker, IR TX, IR RX, IMU, 3 buttons, battery |
| LILYGO T-Display | ![]() |
13 GPIO (1 Qwicc), screen, 2 buttons |
| LILYGO T-Embed | ![]() |
9 GPIO (Grove, Header), screen, encoder, speaker, mic, SD card |
| LILYGO T-Embed CC1101 | ![]() |
4 GPIO (2x Qwiic), screen, encoder, speaker, mic, SD Card, CC1101, PN532, IR TX, IR RX , battery |
| LILYGO T-Embed CC1101 Plus | ![]() |
4 GPIO (2x Qwiic), screen, encoder, speaker, mic, SD Card, CC1101, NRF24, PN532, IR TX, IR RX , battery |
| Heltec WiFi LoRa 32 V4 | ![]() |
15 GPIO (Header), SX1262 LoRa, 2 buttons, screen not supported |
| Heltec Vision Master T190 | ![]() |
15 GPIO (Header, Qwiiic), screen, 2 buttons, SX1262 LoRa |
| Seeed Studio Xiao S3 | ![]() |
9 GPIO (exposed pins), 1 button |
| Waveshare ESP32-S3-GEEK | ![]() |
7 GPIO (Dupont header), screen, 1 button, SD card |
| Unexpected Maker ProS3 | ![]() |
More than 20 available GPIO (Header, STEMMA QT), 1 button |
Other ESP32-S3-based Boards
All boards based on the ESP32-S3 can be supported, provided they have at least 4 MB of flash.
You can flash the s3 dev-kit (8MB flash) or supermini (4MB flash) firmware onto any ESP32-S3 board.
Keep in mind that the default pin mapping in the firmware may not match your specific board.
🔧 Flash the firmware
🔌 Connect via Serial or Web
🧪 Use commands like:
mode
help
scan
sniff
...
📚 Visit the Wiki for detailed documentation on every mode and command.
Includes:
The wiki is the best place to learn how everything works.
🛠️ Automate interactions with the ESP32 Bit Pirate using Python scripts over serial.
You can write and test scripts directly in the browser with the ESP32 Bit Pirate Python Lab.
Including: Logging data in a file, eeprom and flash dump, interracting with GPIOs, LED animation...
🔌 Expand the capabilities of the ESP32 Bit Pirate with additional hardware modules. The Expander adds support for the WiFi 5 GhZ, Zigbee or other radio protocols.
🔧 A docking station for the ESP32 S3 DevKit designed to work with original Bus Pirate adapters. It allows you to plug and use the original Bus Pirate ecosystem of adapters and accessories.
Get the ESP32 Bit Pirate Dock on PCBWay.
The ESP32 Bit Pirate firmware provides three command-line interface (CLI) modes:
| Interface | Advantages | Ideal for... |
|---|---|---|
| Web Interface | - Accessible from any browser - PC, tablets, mobiles - Works over Wi-Fi - No cables needed |
Quick tests, demos, headless setups |
| Serial Interface | - Faster performance - Instant responsiveness - Handles large data smoothly |
Intensive sessions, frequent interactions |
| Standalone | - Only for the Cardputer - On device keyboard - On device screen |
Portable sessions, Quick tests |
All interfaces share the same command structure and can be used interchangeably (more details).


See How To Contribute section, which outlines a simple way to add a new board or a new command.

See images, logo, presentations, photo, video, illustrations. These visuals can be freely used in blog posts, documentation, videos, or articles to help explain and promote the firmware.
⚠️ Voltage Warning: Devices should only operate at 3.3V or 5V.
- Do not connect peripherals using other voltage levels — doing so may damage your ESP32.
⚠️ Usage Warning: This firmware is provided for educational, diagnostic, and interoperability testing purposes only.
- Do not use it to interfere with, probe, or manipulate devices without proper authorization.
- Avoid any unauthorized RF transmissions (e.g., sub-GHz) that could violate local regulations or disrupt networks and communications.
- The authors are not responsible for any misuse of this software or hardware, including legal consequences resulting from unauthorized access or signal emission.
- Always stay within the bounds of your country’s laws and responsible disclosure policies.