How to Update the Flipper Zero SD Card Structure Correctly

The SD card is Flipper's storage for saves, apps, and settings. Knowing the correct structure prevents corruption and missing files.

Required SD Card Format

• FAT32 format
• Any class SD card works, Class 10 or better recommended
• Up to 256GB supported

Correct Directory Structure

/
├── badusb/          — BadUSB DuckyScript files
├── dolphin/         — Animation files and manifest
├── infrared/        — IR remote saves (.ir files)
├── ibutton/         — iButton saves
├── lfrfid/          — 125kHz RFID saves
├── nfc/             — NFC card saves
├── subghz/
│   ├── assets/      — Protocol databases
│   └── saved/       — Captured signals
├── music_player/    — .fmf and .rtttl music files
├── apps/            — Installed .fap app files
│   ├── GPIO/
│   ├── Games/
│   ├── NFC/
│   └── [other categories]/
├── apps_data/       — App settings and data
└── .catalog/        — App catalog metadata (auto-created)

Initializing a Fresh SD Card

1. Format SD card as FAT32 on your computer
2. Insert into Flipper
3. Flipper auto-creates the required folder structure on first boot
4. Or use qFlipper → format option

If Files Are Missing

If Flipper can't find apps or saves:

1. Check folder names are exactly right (case-sensitive on some systems)
2. Verify file extensions match expected types
3. Re-download app from lab.flipper.net to regenerate

Backing Up Before Firmware Updates

Before updating firmware (especially to custom firmware):

1. Connect to qFlipper
2. Download entire SD content to your computer
3. Update firmware
4. If anything breaks, restore from backup

SD Card Corruption

Signs of SD corruption:

• Flipper can't read files it just saved
• Missing apps that were installed
• Random crashes

Fix: backup SD contents, reformat as FAT32, restore files.

Use reputable SD cards — Sandisk and Samsung are reliable.