Enkeisha Emulator guides

mGBA setup guide

Boot a GBA game and keep your progress when you move

Open one game, check the controls and use a writable folder for saves. The standalone mGBA app and its RetroArch core use different default save extensions.

Guide edition 3.3 · Reference build 0.10.5 · Test record: 19 November 2026

Install the standalone app

mGBA runs Game Boy Advance, Game Boy and Game Boy Color software. Choose the right build at the official download page.

PlatformFirst steps
WindowsPick the installer or fully extract the portable 7z and open mGBA.exe. Keep games in a folder you can write to, outside Program Files.
macOSOpen the modern DMG and copy the app to Applications. Check the legacy version if your macOS is too old.
LinuxUse the AppImage for your CPU and make it executable, or use the package matching your Ubuntu version.

Open one GBA or Game Boy file

  1. Start with one extracted file: .gba for GBA, .gb for Game Boy, or .gbc for Game Boy Color.
  2. In mGBA, choose File → Load ROM. The Windows shortcut is Ctrl+O.
  3. Check movement, confirm and pause after the title screen. Standard GBA play can start without an external BIOS.

Example on Windows

We opened the Japanese release of Double Dragon Advance and reached both the title and opening sequence.

The title screen appeared after we opened the GBA file.Captured by Enkeisha. Double Dragon Advance (Japan) ©2004 ATLUS / MILLION
The opening sequence rendered in mGBA 0.10.5 for Windows.Captured by Enkeisha. Double Dragon Advance (Japan) ©2004 ATLUS / MILLION
We used scripted input to reach Mission 1 and confirm that the game rendered during combat.Captured by Enkeisha. Double Dragon Advance (Japan) ©2004 ATLUS / MILLION
mGBA captured this running homebrew at the GBA’s native 240×160 resolution.Enkeisha capture from mGBA 0.10.5 for Windows

Map controls

Open Tools → Settings, then pick Keyboard or Controllers. Check the directions, A, B, L, R, Start and Select. In our test setup the arrows controlled the D-pad, X was A, Z was B, and Enter was Start. Connect the gamepad before mapping. If the controller fails, try the keyboard to narrow down whether the issue is the device or the emulator. Also check for shortcut keys that overlap with in-game keys.

Fix a blank display or uneven speed

Symptom or goalFirst thing to try
Sharp pixelsUse a 2× or 3× window scale and check smoothing or shader settings.
Black screenTry the compatible OpenGL mode or Software display driver as described by the developer.
Game runs too fastTurn off Fast Forward in Emulation. Check that audio or video sync is enabled.
Audio stuttersRemove display filters temporarily, then test audio driver and sync settings one at a time.

Official troubleshooting FAQ

Transfer battery saves and use save states

A game’s normal save is generally a .sav file. Check beside your game file or look under Paths if you changed the save directory. On Windows 0.10.5, Shift+F1 saves state slot 1 and F1 loads it with the default shortcuts. Press F10 to open Load State and see a thumbnail for each occupied slot. In our Double Dragon Advance test, slot 1 restored the saved opening scene after a reset.

  1. Make an in-game save and quit. Check the save name and timestamp. MyGame.gba typically pairs with MyGame.sav.
  2. With mGBA closed, copy the game and save to the matching location on the new system. Keep any existing save from the destination as a separate backup.
  3. Boot normally and choose Continue in the game. When moving from the RetroArch mGBA core, try a copy of its .srm renamed to .sav if the save format matches. Confirm that the new app can both read and write the save.

Save format for the RetroArch core

This is the frame saved in slot 1. F1 restored this scene after a reset.Captured by Enkeisha. Double Dragon Advance (Japan) ©2004 ATLUS / MILLION

Troubleshooting and FAQ

For a white screen, try a known-good local file and consult the official FAQ for audio driver and synchronization settings. For missing saves on older Windows setups that kept games in Program Files, inspect the save path and check %LOCALAPPDATA%\VirtualStore.

Frequently asked questions

Is this the Android or iOS mGBA app?

These steps cover the standalone desktop app. Mobile frontends using the mGBA core have different controls and storage paths.

Can I rename a state into a normal save?

Their formats are different. Load the state in the old environment and make an in-game save there.

What should I back up before updating?

Keep copies of battery saves and save states, plus your settings if needed. Verify that your regular save loads before replacing the backup.

Image viewer