Computer setup guide

Install Gen2Recomp on Windows, Mac and Linux

Install Gen2Recomp 0.8.12 on Windows, Mac or Linux, import one or several supported games, and keep your saves safe.

Last updated:

Choose the correct computer download

Windows ZIP

Gen2Recomped-0.8.12-windows.zip is the simplest choice. Extract it and open Gen2Recomped.exe.

Windows MSIX

Gen2Recomped-0.8.12-windows.msix installs like a Windows app after its matching certificate is trusted once.

Mac

Extract Gen2Recomped-0.8.12-macos.zip, move the app to Applications and open it.

Linux and Steam Deck

Extract Gen2Recomped-0.8.12-linux.zip and run the AppImage. Steam Deck uses Desktop Mode.

Install and start Gen2Recomp

  1. Download the package for your computerUse the exact 0.8.12 filename shown on the Download page.
  2. Extract the full ZIP when using Windows, Mac or Linux ZIP packagesKeep every extracted file together in its own folder.
  3. Open Gen2RecompWindows uses the app file, Mac uses the app moved to Applications, and Linux uses the AppImage.
  4. Import a compatible Pokemon gameSelect your own legally obtained file when the launcher asks.
  5. Add more recognized games if wantedUse the import option again for each game you want in the launcher.
  6. Create and test a save profileWalk, open menus, enter a battle and save before enabling mods or editors.

Important notes for each system

Windows ZIP warnings

Confirm the full filename came from the current Download page and scan it normally. Do not turn off protection for the whole computer.

Windows MSIX certificate

The matching Gen2Recomped-0.8.12-windows.cermust be trusted once before the MSIX can install. Later 0.8.12 reinstalls do not need that step again.

Mac approval

If macOS blocks the downloaded app, use the normal Privacy & Security approval for this app instead of disabling protection for all apps.

Linux permission

If the AppImage does not open, allow it to run from the file's properties, then try again. Keep its working files together.

Updates and portable use

Desktop builds can check for newer Gen2Recomp versions automatically. Back up important saves before accepting a major update, then test the normal game before turning optional mods back on.

Portable mode is available when you want the app and its data kept together. Close Gen2Recomp before moving the folder and keep a separate save backup before testing it on another computer.

If setup fails, use the troubleshooting guide.