docs(switch): add switch-install player guide

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
Andrew Quenehen
2026-08-01 12:49:57 -03:00
parent 1f0712d2d5
commit e40f9337b6
+66
View File
@@ -0,0 +1,66 @@
# 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](https://github.com/bryanthaboi/gen1recomp/issues/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](switch-build.md).
## 1. Download the NRO
1. Open
[Releases](https://github.com/bryanthaboi/gen1recomp/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:
```text
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 games 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](switch-build.md). Hardware evidence and contributor MTP
loops: [switch-development.md](switch-development.md).