M5Stack Launcher

What you’re building

M5Stack Launcher is firmware for managing and replacing ESP32 application binaries without repeatedly returning to a desktop flashing workflow. The repository supports Cardputer and many M5Stack, LilyGO, Marauder, and CYD devices, with device-specific release binaries. Once installed, Launcher can install firmware from microSD, fetch compatible binaries through OTA sources such as M5Burner or GitHub links, or accept uploads through its WebUI; it also exposes SD file management and backup functions. The expected result is a bootable on-device firmware picker and installer rather than a multi-boot runtime. A crucial constraint is that writing another firmware replaces the currently active firmware and may alter partitions or filesystems; users should choose the exact device binary and back up SD, SPIFFS, or FAT data before formatting or installation.

Key steps

1. Download the Launcher release binary whose filename matches the exact device model.
2. Flash the matching Launcher binary with the linked web flasher or esptool and reboot into Launcher.
3. Place compatible firmware binaries on microSD, or select OTA to browse online M5Burner or GitHub sources.
4. Choose a binary, review any partition or SPIFFS prompt, and allow Launcher to validate and install it.
5. Use the WUI option when wireless upload or SD file management from a phone or computer is preferred.