Marauder Desktop v1.1.0 — in-app ESP32 flasher

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.

Marauder Desktop 1.0.0

Marauder Desktop is a desktop controller for the ESP32 Marauder firmware — the same Compose Material 3 UI as the Marauder Mobile app. Plug an ESP32 in over USB and drive it headlessly: WiFi & Bluetooth sniffers, scanners and attacks, GPS tools, live analyzers and device lists — every command opens its own live results screen.

This build ships a ready-to-run Linux package (bundled Java runtime — nothing else to install).

Install (Linux)

One-line — recommended:

curl -fsSL https://raw.githubusercontent.com/0xsys/ESP32-Marauder-Desktop/main/install.sh | bash

Or download and run:

Platform	File
Linux (portable, x64)	MarauderDesktop-linux-x64.tar.gz

Extract it and run MarauderDesktop/bin/MarauderDesktop.

Windows

Windows packages (.msi and a portable .zip) are produced automatically by the
repo's GitHub Actions on each tagged release, or you can build one on Windows with
./gradlew packageMsi. See the README.

Highlights

• Full firmware menu tree mirrored from the device: WiFi (Sniffers / Scanners / Attacks / General), Bluetooth (Sniffers / Attacks), GPS, Device.
• Interactive by design — every command opens a live view (streaming console + auto-refreshing list + live counters + Stop).
• Live structured lists (APs, Stations, SSIDs, IPs, Probe Requests, AirTags) and live analyzers (Channel / Bluetooth / Channel Summary).
• Raw serial console, dark/light theme, attack-confirmation dialogs.
• Cross-platform USB serial via jSerialComm (115200 8N1, the firmware's @J JSON protocol).

Notes

• Linux serial permissions: add yourself to dialout (Debian/Ubuntu) or uucp (Arch/CachyOS), then log out and back in.
• Requires an ESP32 running the Marauder firmware.