gen1recomp/docs/switch-install.md

Install Gen1Recomp on Nintendo Switch

Every GitHub Release that includes Switch support ships a fused homebrew binary: gen1recomp-*-switch.nro. Copy it to your microSD, launch with title override, then import your own legal .gb ROM.

Experimental. The Switch port is still WIP (issue #531). Hardware evidence so far is Switch OLED only — other models are untested. You need a console that can run Switch homebrew (custom firmware / hbmenu). This project does not help you set that up.

Prefer building from source? See switch-build.md.

1. Download the NRO

1. Open Releases.
2. Download gen1recomp-*-switch.nro for the version you want. (Optional: the matching *.nro.sha256 sidecar if you want to verify the download.)

2. Copy it to the microSD

Put the file here on the SD card:

sdmc:/switch/gen1recomp/gen1recomp.nro

(or keep the versioned name under sdmc:/switch/gen1recomp/ — hbmenu will list it either way).

Any method that lands the file on the SD is fine: DBI → Run MTP responder plus an MTP client, Hekate UMS, a card reader, etc. Exit MTP / unmount cleanly before launching.

3. Launch with title override

Applet Mode is not supported for this game (not enough memory).

1. On the Switch HOME menu, highlight any installed title.
2. Hold R and launch that title — this opens hbmenu with full memory (title override).
3. From hbmenu, open gen1recomp.

Do not launch from the Album applet path for normal play.

4. Import your ROM

This project ships no game data. On first launch:

1. Put your own legally obtained Pokémon Red or Blue .gb into the ROM inbox under the game’s save directory (imports/ — the launcher shows the live path).
2. Use Procurar novamente / rescan on the Red/Blue tab if you add the file after the first open.

Saves live in the LÖVE save directory and persist across NRO updates — you can replace only the .nro and keep your progress.

Prefer building it yourself?

Building the fused (or loose) NRO from source is covered in switch-build.md. Hardware evidence and contributor MTP loops: switch-development.md.