SYS: FANTASI WIKI PAGE: QUICKSTART_
← HOME

Quickstart

Get Fantasi onto your device and manage it from your browser.

The web flasher installs Fantasi on a Flipper Zero, Kiisu, Chameleon Ultra, Proxmark3, or Proxmark5 straight from your browser - no toolchain to install, no commands to run:

  1. Open the web flasher in Chrome or Edge (it uses WebUSB / Web Serial).
  2. Click Connect
  3. Click Flash Fantasi.

It auto-detects the device, installs the STM32WB BLE radio stack for Flipper/Kiisu automatically, verifies the written image before it boots, and updates an existing Fantasi install in place. This is the easiest path and can't brick the device - if a write fails it leaves the bootloader intact so you can retry.

If you prefer the command line, or use a browser without WebUSB, you may build and flash from source instead.

Build and flash from source

Four steps are required to build Fantasi and flash it to a supported device.

1. Install the tools

Set up the build and flashing tools on your computer - see Dependencies for the one-line install.

2. Enter DFU mode

Put your device into its bootloader (DFU) mode. Pick your device:

Flipper Zero
  1. Unplug the USB cable from your Flipper Zero if connected.
  2. Press and hold the OK and BACK buttons for 30 seconds. It is normal for the screen to stay blank.
  3. Keeping them held, connect your Flipper Zero to your computer via USB.
Chameleon Ultra

Use any one of these methods.

Physical button:

  1. Disconnect the Chameleon and wait for it to enter sleep mode.
  2. Hold down the B button. On Windows, wait ~5 s before the next step.
  3. Plug USB into the PC while still holding the button. On Windows, wait ~10 s.
  4. Release the B button.

From the CLI: run hw dfu.

From the GUI: click Enter DFU mode.

While waiting in DFU mode, LEDs 4 and 5 blink green alternately. The device stays in DFU mode for ~30 s.

Proxmark3
  1. Disconnect from the PC.
  2. Hold the side button as you reconnect.
  3. Success is indicated by the orange and green LEDs staying on.
Kiisu
  1. Disconnect USB and remove the battery.
  2. Hold the OK button (4).
  3. Connect Kiisu (USB-C) to the PC (2).
  4. The main MCU switches to DFU mode. The screen stays blank.
Proxmark5

When the official Proxmark5 firmware is running, the web flasher recognizes the board through its capabilities response and sends CMD_START_FLASH to reboot it into the official flashing bootloader automatically, just as it does for a Proxmark3. No button sequence is needed for that normal installation path.

For recovery or a board already in ROM DFU:

  1. Disconnect the device from USB.
  2. Hold the button while reconnecting it (about 6 seconds).
  3. The AT32 ROM DFU bootloader enumerates as 2e3c:df11.
  4. In the web flasher, click ROM DFU to grant that WebUSB device directly.

3. Flash the firmware

Run make flash with your target:

DeviceCommand
Flipper Zeromake PLATFORM=flipper flash
Chameleon Ultramake PLATFORM=chameleon flash
Proxmark3make PLATFORM=proxmark3 flash
Kiisumake PLATFORM=kiisu flash
Proxmark5make PLATFORM=proxmark5 flash

4. Flipper Zero & Kiisu - install the BLE radio stack

STM32WB devices also need the wireless (BLE) stack. With the device in DFU mode, run the flasher with no arguments - it fetches the correct binary, verifies it against a known SHA-256, caches it under build/copro/, and installs it:

python3 tools/radio_flash.py

The default is stm32wb5x_BLE_Stack_full_extended_fw.bin, pinned to flipperdevices/stm32wb_copro tag v1.20.0. Pass a path to flash a specific binary you already have. See Radio Stack for details.

Done

Your device now runs Fantasi. Open the Launcher to manage it from your browser.

For the full per-target procedure, recovery, and SWD paths, see the docs/ directory in the firmware repo - especially flashing.md and radio_stack.md.

★ DREAM // HACK ★