Quickstart

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

Flash from your browser (recommended)

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

Open the web flasher in Chrome or Edge (it uses WebUSB / Web Serial).
Click Connect
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

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

Chameleon Ultra

Use any one of these methods.

Physical button:

Disconnect the Chameleon and wait for it to enter sleep mode.
Hold down the B button. On Windows, wait ~5 s before the next step.
Plug USB into the PC while still holding the button. On Windows, wait ~10 s.
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

Disconnect from the PC.
Hold the side button as you reconnect.
Success is indicated by the orange and green LEDs staying on.

Kiisu

Disconnect USB and remove the battery.
Hold the OK button (4).
Connect Kiisu (USB-C) to the PC (2).
The main MCU switches to DFU mode. The screen stays blank.

3. Flash the firmware

Run make flash with your target:

Device	Command
Flipper Zero	`make PLATFORM=flipper flash`
Chameleon Ultra	`make PLATFORM=chameleon flash`
Proxmark3	`make PLATFORM=proxmark3 flash`
Kiisu	`make PLATFORM=kiisu 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.