Skip to content

Marauder Desktop v1.1.0 — in-app ESP32 flasher

Latest

Choose a tag to compare

@0xsys 0xsys released this 04 Aug 16:09
· 1 commit to main since this release

Marauder Desktop v1.1.0 — in-app ESP32 flasher

Flash and update your ESP32 Marauder from the desktop app itself — no PC-side
esptool, no separate tooling. Marauder Desktop can now download the firmware and
write it to the board over the same USB serial connection it uses to control it.
This mirrors the feature just added to Marauder Mobile.

What's new

  • In-app firmware flasher. A new Flash & Update flow writes the Marauder
    firmware to a connected ESP32 straight from the app.
  • Two entry points:
    • Before connecting — a Flash / update firmware button on the connect
      screen, so you can flash a fresh or bricked board without a working session.
    • After connecting — a Flash & Update item in the main menu.
  • Downloads the firmware for you from the pinned release
    v1.12.3-jsonserial
    on 0xsys/ESP32Marauder, then flashes it over USB and verifies every byte
    against the device's own MD5 before rebooting into the new firmware.
  • Fast transfer. Uses a higher baud rate and compressed writes, with an
    automatic fallback to a plain, maximally-compatible transfer if the board
    rejects the fast path — so a flash never fails just for being fast.

How to flash

  1. Connect the ESP32 over USB and launch Marauder Desktop.
  2. Open Flash & Update (from the connect screen, or the main menu once
    connected) and pick the serial port.
  3. Confirm. The app downloads the firmware, writes it, verifies it, and reboots
    the board. Keep the cable connected until it finishes.

If flashing fails

Put the ESP32 into boot (download) mode by hand and try again:

  1. Hold the BOOT / IO0 button.
  2. Briefly tap EN / RST.
  3. Release BOOT — the board is now waiting for firmware.
  4. Start the flash again.

Compatibility

  • Target board: marauder_v4 (classic ESP32 / ESP32-WROOM). Other chip
    families (S2 / S3 / C3) use different flash offsets and reset timing and are
    not covered by this release yet.
  • Platforms: Linux and Windows.
  • Internet: required the first time, to download the firmware image.

Linux serial permissions — your user must be allowed to open the serial
device. Add yourself to the dialout group (Debian/Ubuntu) or uucp group
(Arch), then log out and back in:

sudo usermod -aG dialout $USER   # or: uucp on Arch

Downloads

Platform File How to run
Windows (portable) MarauderDesktop-windows-x64.zip Extract, run MarauderDesktop\MarauderDesktop.exe. Bundles its own runtime.
Linux (portable) MarauderDesktop-linux-x64.tar.gz Extract, run MarauderDesktop/bin/MarauderDesktop. Bundles its own runtime.

The .msi (Windows) and .deb (Debian/Ubuntu) installers are produced by the
release CI when a v* tag is pushed, and attached here automatically.

Responsible use

This project controls wireless-security firmware. Use it only on devices and
networks you own or are authorised to test.