Media and Storage

Media and Storage

The SD card is the badge's content library. Extract release archives to the card root so the following folders are present.

Path	Contents
/APPS	.DC32 apps and their documented companion data
/ICONS	Browser-rendered Unicode Emoji 17.0 loading icons installed by SD-apps.zip as 32, 48, and 64 px DCEI RGBA assets
/ROMS/AB	Arduboy .hex and .arduboy games
/ROMS/GB	Game Boy ROMs
/ROMS/GBC	Game Boy Color ROMs
/ROMS/NES	NES ROMs
/SAVE/AB, /SAVE/GB, /SAVE/GBC, /SAVE/NES	Emulator saves named from the ROM filename
/SAVE/PORTS	Native-port saves
/SAVE/PORTS/LASERTAG.DAT	Laser Tag identity, color, and persistent statistics
/SAVE/PORTS/SOCCER	Sensible Soccer competitions, teams, tactics, replays, highlights, and import/export files
/IR	Universal Remote and Flipper-style IR files
/BADUSB	.txt and .badusb scripts
/MUSIC	ABC, MIDI, and RTTTL music files
/IMAGES	JPEG, uncompressed BMP, and DC32-compatible GIF files

Supported media

• Music: .abc, .mid, .midi, .rtttl, and RTTTL .txt files. Track focus selects ABC voices or MIDI format-1 tracks.
• Images: .jpg, .jpeg, uncompressed .bmp, and DC32-compatible .gif files.
• Arduboy: .hex and .arduboy files.

Arduboy emulation is playable but not 100% accurate; demanding titles can run more slowly, and Arduboy audio is not emulated.

Preparing optional content

• python tools/image_converter.py converts images and animations to browser-compatible .gif files with a DC32 playback payload. It crops each frame to its non-black content rectangle before scaling.
• python tools/build_chips_pack.py creates /APPS/chips.pak from user-provided Windows 3.1 Chip's Challenge data.
• python tools/build_openjazz_pack.py creates /APPS/openjazz.pak from user-provided Jazz Jackrabbit data. The badge can also convert the bundled shareware JAZZ.ZIP on first launch.

Other scripts in tools/ support the firmware build and release packaging rather than SD-card content preparation.

Legal and safe use

ROMs and proprietary game data are not included. Add only files you are legally permitted to use. Treat BadUSB scripts and infrared transmissions carefully: they can affect connected devices or nearby equipment.