pio run -e cardputer      # .pio/build/cardputer/firmware.bin -> install via the Launcher
pio run -e native         # desktop simulator (SDL2), 240x135 at 3x
.pio/build/native/program # laptop keys: arrows = Fn+;./  Alt = Fn  Esc = `
tools/shots.sh shots      # headless screenshots + WAVs of every rite

The simulator plays audio through SDL, or to a file with GRIM_WAV=out.wav; GRIM_SCRIPT drives it headless (see src/hal_native.cpp). A prebuilt device image is in dist/.

Installing on the Cardputer

Copy firmware.bin to the SD card and install it from the Launcher, or push it over USB serial while the Launcher is running (the Launcher grows the app partition to fit). The ADV is a full wipe from the factory firmware — back up first with esptool read-flash 0 0x800000 backup.bin.