---

name: run-local description: Run DSVita locally on the dev machine under qemu-arm and take screenshots — use when asked to launch the emulator locally, boot a rom for a quick correctness check, open the menu UI, or capture what the local emulator window shows.

Run DSVita locally (qemu-arm)

Prerequisite: a .env in the repo root (copy .env.example, fill in DSVITA_SYSROOT, DSVITA_ROMS_DIR, DSVITA_TEST_ROM). All tools/ scripts source it automatically.

Build first (dev profile has overflow-checks + debug-assertions on):

cargo build --profile release-debug --target thumbv7neon-unknown-linux-gnueabihf

| action | command | |---|---| | Boot the test rom ($DSVITA_TEST_ROM) | tools/launch_hw.sh | | Open the menu UI on $DSVITA_ROMS_DIR | tools/launch.sh | | Screenshot the emulator window | tools/shot.sh <out.png> | | Stop | pkill -9 -f "release-debug/dsvita" |

Runtime log: /tmp/dsvita.log. The emulator runs detached; give it a few seconds before screenshotting.

Constraints:

• The dev machine is x86, so the armhf binary only runs here under qemu-arm — ~100x slower than native, fine for a quick correctness check, useless for perf. Default to running roms/games on the pi5 test box (run-on-testbox skill; roms there live at ~/nds); reach for qemu locally only for a fast boot/correctness sanity check.
• Under Xwayland, mouse injection reaches SDL but keyboard does NOT — touch-navigable flows can be driven (mouse click on the bottom-screen area = touch), button-only flows cannot.
• CLI: -f 0|1|2.. framelimit (0 = uncapped, 1 = 100%, 5 = 200%, 9 = 500%), -e 0|1|2 = ARM7 mode (AccurateLle / SoundHle / Hle), --ui <dir> menu mode.