Skip to content
LayfatePublic

About

Open-source Android emulator for Game Boy, Game Boy Color, and Game Boy Advance, powered by mGBA.

Topics

Resources

Contributing

Security policy

Stars

5 stars

Watchers

2 watching

Forks

Repository files navigation

Retra logo

Retra

Game Boy, Game Boy Color and Game Boy Advance on Android

Play your games with an accurate mGBA core, a cover-art library, customizable controls and built-in source browsing.

GitHub downloads CI License: MPL-2.0

Download

Retra Stable

Requires Android 8.0 or higher.

Screenshots

Browse sources, dark theme Source catalog with pinned header, dark theme Source catalog, light theme Settings, light theme

Features

  • Play GB, GBC and GBA games with up to 16× fast-forward, slow motion, cheats, ROM patches and shaders.
  • Smooth interface at your display's full refresh rate, up to 120 Hz.
  • A library with cover art, categories, search, sorting, history and playtime statistics.
  • Browse source extensions like Mihon: search catalogs, view game details and download into your library, with a Downloads tab.
  • Battery saves, save states, auto-resume, .sav / .srm import, portable .retra backups and optional Google Drive backup.
  • Editable controls with separate portrait and landscape layouts.
  • Local Link, Single-Pak / Multiboot and Remote Link over Wi-Fi or Bluetooth.
  • Light, dark and translucent themes.
  • Plus much more...

Performance

Retra v1.0.3 at a glance.

Game speed Runs at the real Game Boy Advance rate of 59.73 fps. On 60 Hz and 120 Hz screens Retra picks the refresh mode that divides evenly into that rate, so every game frame is shown for the same time and motion doesn't stutter.
Fast-forward and slow motion 0.2×, 0.5×, 2×, 4×, 8× and 16×, each held at its exact speed. At 8× and 16× Retra skips drawing some frames, never game logic, and shows up to 165 frames per second on fast screens. If a phone can't keep up, it skips more drawing instead of slowing the game down.
Audio One 32-tap resampler converts the console's sound to the phone's rate without clipping or crackle. It starts with a 32 ms buffer and an 80 ms device buffer, and only grows the buffer (up to 112 ms) after a real dropout. Changing speed clears old audio, so sound doesn't lag behind the picture.
Shaders RetroArch .slang shaders are compiled on the phone and run on the GPU.
Interface Library, Browse and settings follow the screen's refresh rate, up to 120 Hz.
Cold start 0.74 s to first frame*
APK size 31.5 MB, including native code for all four CPU types (arm64, 32-bit ARM, x86 and x86_64)

* Measured on a Redmi Note 13 (Snapdragon 685, 120 Hz display, Android 15), release build, median of 5 launches, on v1.0.2.

Reproduce
adb shell am force-stop com.retra.emulator
adb shell am start -W -n com.retra.emulator/.MainActivity   # see "TotalTime"

Extensions

In Retra, open Browse → Extensions → ⋮ → Extension repos → Add and paste:

https://raw.githubusercontent.com/Layfate/Retra/main/extensions/index.json

Install Retra Sources, then open Sources. Search games across every source with the search icon, and find what you download in the Downloads tab and in Library. See the source guide for the included websites and how downloads work.

Building

Developer setup

Use Android Studio with JDK 17 and the project's Android SDK, NDK and CMake versions. Python 3 is needed to prepare the mGBA core.

git clone https://github.com/Layfate/Retra.git
cd Retra
python3 tools/prepare_mgba.py

On Windows, use python if python3 is unavailable. The setup script fetches the mGBA revision pinned in third_party/mgba.lock. Then open the project in Android Studio, let Gradle sync, and run it on a device or emulator.

Contributing

Contributing guide · Troubleshooting · Documentation · Changelog · Security

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Before reporting a new issue, take a look at Troubleshooting, the changelog and the already opened issues.

Credits

Retra is built on the mGBA emulator core by endrift and contributors. See Third-party notices.

Thank you to everyone who has contributed!

Retra contributors

Disclaimer

Retra does not include any games or BIOS files, and the developer(s) have no affiliation with Nintendo or with the content providers available through extensions. Use only games and files you are legally allowed to use.

License

Copyright © 2026 Zense and Retra contributors

This Source Code Form is subject to the terms of the Mozilla Public
License, v. 2.0. If a copy of the MPL was not distributed with this
file, You can obtain one at https://mozilla.org/MPL/2.0/.

The mGBA core retains its own copyright and license notices.

About

Open-source Android emulator for Game Boy, Game Boy Color, and Game Boy Advance, powered by mGBA.

Topics

Resources

Contributing

Security policy

Stars

5 stars

Watchers

2 watching

Forks

Releases

Packages

Contributors

Languages