Game Boy Advance (gpSP)Link

Contribute to this documentationLink

In order to propose improvements to this document, visit its corresponding source page on github. Changes are proposed using "Pull Requests."

There is a To-Do list for libretro/docs here


gpSP is a Game Boy Advance emulator based on notaz' fork of gpSP with additional codebase improvements.

Why use this core?Link

Awaiting description.

How to get and install the gpSP core:Link

  1. Start up RetroArch. Inside the main menu, go to 'Online Updater'.

  2. Just to make sure we have the latest info files, select 'Update Core Info FIles'. Wait until this is done. Then, select 'Core Updater'.

  3. Browse through the list and select 'Game Boy Advance (gpSP)'.

After this has finished downloading, the core should now be ready for use!

How to start (after installation):Link

  1. Go back to RetroArch's main menu screen. Select 'Load Content'.

  2. Browse to the folder that contains the content you want to run.

  3. Select the content that you want to run.

  4. If you are asked which core to select, choose 'Game Boy Advance (gpSP)'.

The content should now start running!


  • Exophase

See alsoLink



A summary of the licenses behind RetroArch and its cores have found here.


Content that can be loaded by the gpSP core have the following file extensions:

  • .gba
  • .bin


RetroArch database(s) that are associated with the gpSP core:


Required or optional firmware files go in RetroArch's system directory.

Filename Description md5sum
gba_bios.bin Game Boy Advance Image - Required a860e8c0b6d573d191e4ec7db1b1e4f6


RetroArch features that the gpSP core respects.

Feature Supported
Netplay ✔ (not link-cable emulation)
Core Options
RetroArch Cheats
Native Cheats
Disk Control
Crop Overscan


The gpSP core's directory name is 'gpSP'

The gpSP core loads from and saves to to these directories.

RetroArch's Save directory

  • 'content-name'.sav (Cartridge backup save)

RetroArch's State directory

  • 'content-name'.state# (State)

Geometry and timingLink

The gpSP core's internal FPS is (FPS).

The gpSP core's internal sample rate is (Rate)

The gpSP core's core provided aspect ratio is (Ratio).


Device typesLink

The gpSP core supports the following device type(s) in the controls menu, bolded device types are the default for the specified user(s):

User 1 device typesLink

  • None - Doesn't disable input.
  • RetroPad - Joypad
  • RetroPad w/Analog - Joypad - There's no reason to switch to this.

Controller tablesLink

Joypad and analog device type tableLink

User 1 input descriptors RetroPad Inputs RetroPad
Select Select
Start Start
D-Pad Up D-Pad Up
D-Pad Down D-Pad Down
D-Pad Left D-Pad Left
D-Pad Right D-Pad Right


Game Issue
Activision Anthology Freezes when entering a game.
Banjo-Kazooie - Grunty's Revenge Black screen during developer logo. Resets when Banjo leaves his house.
Boktai Trilogy The solar sensor is not emulated.
DemiKids - Light/Dark Version Crashes when entering a battle.
Digimon Racing (Europe) Freezes during the intro.
Dragon Ball Z - The Legacy of Goku Graphics glitches. (1)
Final Fantasy VI Background/tiling order issues.
Game Boy Advance Video - Dragon Ball GT - Volume 1 White screen.
Grand Theft Auto Advance Crashes after first dialog.
Harry Potter - Quidditch World Cup Crashes when going ingame.
Koro Koro Puzzle Happy Panechu! The tilt sensor is not emulated.
Mario & Luigi - Superstar Saga Crashes when entering a battle.
Phantasy Star Collection Phantasy Star 1 flickers.
R-Type III - The Third Lightning Softlocks at Irem startup screen.
Rock 'n Roll Racing Corrupted graphics, not playable.
Rockman & Forte Doesn't continue after GBA BIOS screen.
Sims 2, The - Pets Graphics glitches. Heavy flickering, black objects. (2)
Street Racing Syndicate Freezes at startup screen, doesn't continue.
Super Monkey Ball Jr. Softlocks at startup screen.
Super Street Fighter II Turbo/X Revival Small graphics glitch. Selecting speed 'Turbo 1' and beyond on the character select screen makes the game speed window not fully visible. (3)
Tales of Phantasia (USA version) Softlocks during the introduction sequence (just before the small guy hits the tall guy in the right).
WarioWare: Twisted! The tilt sensor is not emulated.
Wolfenstein 3D Softlocks at id Software startup screen.
Yoshi’s Universal Gravitation The tilt sensor is not emulated.