Enkeisha Emulator guides

RetroArch setup guide

Get your first game running, then set up controls and saves

RetroArch provides the menus, input and storage. A core handles the console itself. Get one GBA file working with the mGBA core before setting up a full library.

Guide edition 3.3 · Reference build 1.22.2 / mGBA 0.11-212-7a12d6d · Test record: 19 November 2026

Install RetroArch for your device

Pick a package from the official platform list. The current stable release checked here is 1.22.2.

PlatformFirst steps
WindowsChoose the package for your CPU. Extract the 7z to a writable folder for a portable setup, then open retroarch.exe.
macOSOpen the official app distribution for your Mac and OS version.
LinuxUse the official distribution path that fits your system. An Ubuntu PPA build can require cores from the package manager.
AndroidInstall from a route linked on the official platform list and choose a game folder Android lets the app read.
iPhone or iPadInstall from the App Store route in the iOS guide and start with a bundled core. Keep game files somewhere you can access in Files.

With a keyboard, use the arrow keys to move, Enter to select and Backspace to go back. Change the menu language in Settings → User → Language.

These are the three main menu items used in the first setup. The menu theme can look different.PC screenshot from official Libretro documentation (1.18.0)

Load a core and open one GBA game

  1. Open Main Menu → Online Updater → Core Downloader and choose Nintendo – Game Boy Advance (mGBA). On a bundled build, look under Load Core instead.
  2. Choose Load Content and select one compatible .gba file. If several cores are offered, choose mGBA.
  3. Check the title and a moment of play. Use Quick Menu for game-specific actions and Close Content to finish.
Read both the system and the core name when choosing a download. This example shows SNES cores. Choose mGBA for GBA.Still frame from the official Libretro Core Downloader walkthrough

An external GBA BIOS is optional for mGBA. Other cores may require firmware. Find the expected name in the core’s documentation and check Settings → Directory → System/BIOS. mGBA core documentation

If the downloader is hidden, check the menu visibility settings and the way your build distributes cores. Automatic library scanning relies on database matches. If direct launch works, try Import Content → Manual Scan to add the file to a playlist. Core installation · Playlists

The Japanese Double Dragon Advance title rendered by the mGBA core in RetroArch 1.22.2.Captured by Enkeisha on Windows. The application/game is identified in the caption.

Set controls globally or per game

For a controller that does not map automatically, use Settings → Input and check the device and Port 1 bindings. For one game, open Quick Menu → Controls → Port 1 Controls, then use Manage Remap Files → Save Game Remap File. Save Core Remap File applies the change to other games that use the same core.

On PC, F1 normally opens Quick Menu while playing. Mobile overlays often provide a menu button. Quick Menu guide

Check the menu shortcut under Settings → Input → Hotkeys → Menu Toggle. A customized setup may not use the default F1 key. Official Quick Menu guide

Check the GBA key bindings on Windows

The default keyboard mapping uses the arrow keys for the D-pad, X for GBA A, Z for B and Enter for Start. Check the active mapping under Settings → Input → RetroPad Binds → Port 1 Controls. The game’s A button is not necessarily the PC’s A key.

Fix scaling or reduce the workload

IssueFirst adjustment
GBA image looks stretchedUse the core’s aspect ratio in Settings → Video → Scaling. GBA games normally use 3:2.
Pixel edges look blurryTry integer scaling and turn off smoothing.
Audio or play stuttersRemove shaders, then test with rewind or run-ahead disabled if enabled. Lower 3D internal resolution in core options where supported.

Change one setting at a time and compare the same scene.

Back up saves before changing cores or devices

The mGBA core typically writes battery saves as .srm and states as .state or numbered variants. Check the Save Files and Save States paths in Settings → Directory.

  1. Save in the game, then use Quick Menu → Close Content. Check the save’s modification time.
  2. Copy the correct file and note any per-core subfolder. Back up remaps and states separately as needed.
  3. Install the same core on the destination. Match the game and save base names, keep a backup of any existing save and test loading normally in the game.

Standalone mGBA often uses .sav. Try a renamed copy only when the two saves use the same format. Directory settings

Save from Quick Menu and return to the same slot

  1. Open Quick Menu during the game and check the number under Save States → State Slot. Our test used slot 0.
  2. Select Save State. This snapshot is separate from a game’s normal save.
  3. Keep the same game and core, select the same slot, then choose Load State. The Windows menu bar also provides Command → State Options → Load State; wording follows the chosen interface language.

We saved the city scene in the opening, reset the game, then restored the same conversation. The tested menu showed F2 for saving and F4 for loading. Check Hotkeys if your setup is customized.

Open Save States in Quick Menu to choose the slot and save/load actions.Captured by Enkeisha on Windows. The application/game is identified in the caption.
Immediately after saving slot 0; the lower-left message confirms the save.Captured by Enkeisha on Windows. The application/game is identified in the caption.
After reset, loading slot 0 restored the saved conversation scene.Captured by Enkeisha on Windows. The application/game is identified in the caption.

Troubleshooting and FAQ

If the file is invisible, check the core’s supported extensions and the app’s access to the folder. If it is visible but will not boot, check the selected core and its firmware requirements. If a setting disappears, check whether you saved a remap, shader preset, core option or override.

Frequently asked questions

Can one core handle several consoles?

Some can. Check the supported consoles and extensions for that core.

Does updating RetroArch also update the cores?

When distributed separately, the app and cores have separate update paths. Back up an in-game save before changing the core.

Does the web build use the same setup?

The web build has its own core picker, Run and Add Content. Follow the installed app’s instructions for its save path and device migration.

Image viewer