What You Need Before Starting
The Nintendo Switch build is made for a console that can already run homebrew through custom firmware and the Homebrew Menu. It is not a normal Nintendo eShop installation, and this guide does not cover modifying a console or setting up custom firmware.
You need:
- a Nintendo Switch that can already open the Homebrew Menu;
- a microSD card used by that homebrew setup;
- the official Gen1Recomp Switch ZIP;
- your own compatible Pokemon Red, Blue or Yellow ROM;
- a way to transfer files through a card reader, MTP or FTP.
The official documentation says the porter validated an OLED system and community testing confirmed that the build boots on V1 / Erista hardware. Compatibility with Switch Lite and other setups is not confirmed by that record.
Step 1: Download the Nintendo Switch Package
Open the Gen1Recomp download page and choose Nintendo Switch — Download SD-ready ZIP. For the current release, the file is named gen1recomp-0.1.65-switch.zip.
The button on this website links directly to the asset published in the official Gen1Recomp GitHub release. If you want to check the file before copying it, compare it with sha256sums.txt from the same official release page (opens in a new tab).
Step 2: Extract Gen1Recomp to the microSD Root
Extract the Switch ZIP at the root of the microSD card. Do not place the ZIP itself inside the switch folder and do not add another outer folder. After extraction, the important paths should look like this:
| Purpose | Expected path |
|---|---|
| Gen1Recomp application | sdmc:/switch/gen1recomp/gen1recomp.nro |
| ROM import folder | sdmc:/switch/gen1recomp/pokemon-love2d/imports/ |
| Mod ZIP inbox | sdmc:/switch/gen1recomp/pokemon-love2d/imports/mods/ |
| Save import and export folders | sdmc:/switch/gen1recomp/pokemon-love2d/imports/saves/... |
Merge folders if your computer asks. The official guide supports three transfer methods:
- Direct microSD: use a card reader or Hekate USB Mass Storage.
- MTP: use DBI's MTP responder with a compatible computer client.
- FTP: transfer through an FTP setup already configured on the console.
Unmount the card or end the MTP / FTP connection cleanly before launching Gen1Recomp. The official Switch transfer guide (opens in a new tab) provides operating-system-specific transfer details.
Updating an Existing Switch Installation
Updating uses the same extract-and-merge process. The new package replaces gen1recomp.nro and the small help files.
Do not delete the pokemon-love2d folder when updating. Imported games, saves, options and mods are stored there. Back up that folder before a major update or before changing storage methods.
Step 3: Launch Through Title Override
Gen1Recomp needs the full memory available through title override. The smaller Album applet mode is not supported.
- Return to the Nintendo Switch HOME menu.
- Highlight an installed title.
- Hold the R shoulder button and launch that title.
- Keep holding R until the Homebrew Menu opens in title-override mode.
- Select gen1recomp from the Homebrew Menu.
Do not start Gen1Recomp through the normal Album applet route. If the application does not appear, recheck that gen1recomp.nro is inside sdmc:/switch/gen1recomp/.
Step 4: Import Pokemon Red, Blue or Yellow
- Copy your compatible Pokemon Red or Blue
.gbfile, or Pokemon Yellow.gbcfile, intoswitch/gen1recomp/pokemon-love2d/imports/. - Launch Gen1Recomp through title override.
- Open the tab that matches the game: Red, Blue or Yellow.
- Choose Scan again on that tab.
- Wait for Gen1Recomp to verify the ROM by its SHA-1 value and prepare the game.
- Select Play when the matching game is ready.
All three compatible ROMs can stay in the same imports folder. Scanning checks only the open game tab, so a Red ROM is not imported from the Yellow tab and a Yellow ROM is not imported from the Blue tab.
If a file is rejected, check the game, region and revision on the Supported Games page. Changing the filename does not change an unsupported ROM's hash.
Nintendo Switch Controls
Gameplay Controls
| Switch control | Action |
|---|---|
| D-pad or left stick | Move |
| A | Confirm |
| B | Cancel |
| + | Start |
| − | Select |
| R without Select | Increase game speed |
| L without Select | Decrease game speed |
Launcher Controls
| Switch control | Action |
|---|---|
| D-pad or left stick | Move the virtual cursor |
| A | Click at the cursor |
| L / R | Move to the previous or next game tab |
| + / − | Play when a ROM is ready; otherwise choose a ROM |
Import or Export a Raw Save File
Gen1Recomp keeps separate save inboxes and export folders for Red, Blue and Yellow under pokemon-love2d.
| Game | Save import inbox | Export folder |
|---|---|---|
| Red | imports/saves/red/ | exports/red/ |
| Blue | imports/saves/blue/ | exports/blue/ |
| Yellow | imports/saves/yellow/ | exports/yellow/ |
To import a cartridge or PC battery save:
- Copy a clean 32 KB Gen 1
.savfile into the matching game's import inbox. - Confirm that the corresponding ROM has already been imported.
- Open that game's tab, choose SAVE FILES, then select Import save.
- After a successful import, Gen1Recomp renames the source to
*.sav.importedand records its content hash so the same file is not imported repeatedly.
A failed import leaves the original file in place. Files such as ._name.sav created by some macOS transfer tools are metadata sidecars, not usable save files.
To move a save off the console, use Export save in the same menu and copy the resulting file from the matching exports/red/, exports/blue/ or exports/yellow/ folder.
Install Community Mods on Nintendo Switch
The Switch build imports mods from a local ZIP inbox:
- Download an installable mod ZIP from its official developer source. The Gen1Recomp Mods directory links to individual repositories and releases.
- Keep the mod compressed unless its developer gives different instructions.
- Copy the ZIP into
switch/gen1recomp/pokemon-love2d/imports/mods/. - Launch Gen1Recomp and open MODS.
- Choose Scan again, enable the imported mod and select Play.
The remote FIND MODS and GitHub-download functions are disabled on Switch, so mod ZIPs must be transferred through microSD, MTP or FTP. Third-party mods can add their own controls and compatibility requirements; check each mod's README before enabling it.
Joy-Con Display Shortcuts
Hold Select (−) and press the listed button. Without Select held, the normal A and B gameplay controls continue to work.
| Joy-Con chord | Matching PC key | Default effect |
|---|---|---|
| Select + A | 2 | COLORS |
| Select + B | 3 | TILT |
| Select + Y | 5 | GBC FX |
| Select + X | 6 | Mod shortcut if a mod registers key 6 |
| Select + L | 7 | Mod shortcut if a mod registers key 7 |
Performance and Troubleshooting
- If the game stutters with extra effects enabled, open Options → Performance and try Low or Balanced.
- If Gen1Recomp closes or fails to load from Album, relaunch it through title override.
- If no game appears after scanning, confirm that the ROM is in the imports folder and that you selected the matching Red, Blue or Yellow tab.
- If an update appears to remove saves or imports, stop and restore your backup rather than deleting or recreating
pokemon-love2d. - If a mod fails, disable the newest mod first and check its documented Gen1Recomp compatibility.
Frequently Asked Questions
Can Gen1Recomp run on a Nintendo Switch without homebrew?
No. The Switch package requires a console that can already run custom firmware and the Homebrew Menu. It is not a normal eShop application.
Why should I use title override instead of Album?
Album opens homebrew in applet mode with limited memory. The official Gen1Recomp Switch instructions require title override so the game can use full memory.
Does the Nintendo Switch download include Pokemon Red, Blue or Yellow?
No. The package includes the Gen1Recomp application but no Pokemon ROM or extracted game data. You must import your own compatible game file.
Can I install Gen1Recomp community mods on Switch?
Yes. Copy a documented installable mod ZIP into the local imports/mods/ inbox, scan it from the Gen1Recomp MODS screen and enable it. Remote mod downloads are disabled on Switch.