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

3 stars

Watchers

0 watching

Forks

Repository files navigation

Retra logo

Retra

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

An open-source emulator powered by mGBA, with a game library, customizable controls, and built-in source browsing.

Version Android License

Download APK · Features · Browse setup · Documentation

Download and install

  1. Download Retra-v1.0.1.apk from the latest release.
  2. Open it on your Android device and allow installation from that source if prompted.
  3. Launch Retra, tap + in Library, and select your games.

Requires Android 8.0 or newer. A GBA BIOS is optional, except for Single-Pak receivers.

Retra does not include ROMs or BIOS files. Use games and files you are legally allowed to use.

Features

What you can do
Play Run GB, GBC, and GBA games with up to 16× fast-forward, slow motion, cheats, ROM patches, and shaders.
Organize Manage your library with cover art, categories, search, sorting, history, and playtime statistics.
Browse Add source extensions, search catalogs, view game details, and open download websites inside Retra.
Save Use battery saves, save states, auto-resume, .sav / .srm import, portable .retra backups, and optional Google Drive backup and restore.
Customize Edit button positions, sizes, and opacity with separate portrait and landscape layouts.
Connect Use Local Link, Single-Pak / Multiboot, or Remote Link over Wi-Fi or Bluetooth.

Your saves, covers, and layouts stay associated with a game when its ROM is moved, renamed, or imported again.

Browse setup

  1. Open Browse → Extensions → ⋮ → Extension repos → Add.
  2. Paste the repository URL below and review the trust prompt.
  3. Install the listed extension, then open Sources to browse its catalogs.
https://raw.githubusercontent.com/Layfate/Retra/main/extensions/index.json

If you used the old repo branch URL, uninstall its extension and remove that repository before adding this URL and reinstalling the extension.

Search across enabled sources from the Search tab. See the source guide for supported websites and download behavior.

Build from source

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.

Open the project in Android Studio, let Gradle sync, and run it on a device or emulator.

See Contributing for validation commands and development guidelines.

Help and contributing

License

Retra is released under the Mozilla Public License 2.0. The mGBA core retains its own copyright and license notices; see Third-party notices.

Made by Zense · Powered by mGBA

About

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

Topics

Resources

Contributing

Security policy

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages