geo-tp/ESP32-Bus-Pirate: A Hardware Hacking Tool with Web-Based CLI That Speaks Every Protocol

ESP32 Bus Pirate is an open-source firmware that turns your device into a multi-protocol hacker’s 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.

• Interactive command-line interface (CLI) via USB Serial or WiFi Web.

• Modes for:

  • HiZ (default)
  • I2C (scan, glitch, slave mode, dump)
  • SPI (flash, sdcard, slave mode)
  • UART / Half-Duplex UART (bridge, read, write)
  • 1-WIRE (ibutton, temp sensor)
  • 2WIRE (smartcard) / 3WIRE (eeprom)
  • DIO (Digital I/O, read, pullup, set)
  • Infrared (device-b-gone, send and receive)
  • USB (HID, mouse, keyboard, gamepad, storage)
  • Bluetooth (BLE HID, scan, spoofing, sniffing)
  • Wi-Fi (scan, AP, connect, sniff, deauth)
  • JTAG (scan pinout, SWD)
  • LED control (animations, set LEDs)
  • I2S
  • CAN

• Protocol sniffers for I2C, Wi-Fi, Bluetooth, 1Wire, CAN.

• Baudrate auto-detection and various tools for UART.

• Registers manipulation, dump tools for I2C.

• Scripting using Bus Pirate-style bytecode instructions.

• Device-B-Gone command with more than 80 supported INFRARED protocols.

• Direct I/O management, PWM, pin state.

• Massive adressable LEDs protocol support.

• Web interface with live terminal, or a classic serial CLI.

📚 Visit the Wiki for detailed documentation on every mode and command.

Includes:

The wiki is the best place to learn how everything works.

1. 🔧 Flash the firmware

   • Download the latest release from the Releases page, and flash it using your favorite tool (esptool.py, PlatformIO, etc.).
   • You can also burn it on M5Burner, in the M5stick, AtomS3, M5StampS3 or Cardputer category.

2. 🔌 Connect via Serial or Web

   • Serial: any terminal app (see Connect via Serial)
   • Web: configure Wi-Fi and access the CLI via browser

3. 🧪 Use commands like:

   See detailed explanations about Terminal Commands and how each one works.

The ESP32 Bus Pirate firmware provides two command-line interface (CLI) modes:

Both interfaces share the same command structure and can be used interchangeably.

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

⚠️ 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.

Keep your files stored safely and securely with the SanDisk 2TB Extreme Portable SSD. With over 69,505 ratings and an impressive 4.6 out of 5 stars, this product has been purchased over 8K+ times in the past month. At only $129.99, this Amazon’s Choice product is a must-have for secure file storage.

Help keep private content private with the included password protection featuring 256-bit AES hardware encryption. Order now for just $129.99 on Amazon!

Help Power Techcratic’s Future – Scan To Support

If Techcratic’s content and insights have helped you, consider giving back by supporting the platform with crypto. Every contribution makes a difference, whether it’s for high-quality content, server maintenance, or future updates. Techcratic is constantly evolving, and your support helps drive that progress.

As a solo operator who wears all the hats, creating content, managing the tech, and running the site, your support allows me to stay focused on delivering valuable resources. Your support keeps everything running smoothly and enables me to continue creating the content you love. I’m deeply grateful for your support, it truly means the world to me! Thank you!