Repository navigation
Releases
Retra v1.0.3
One-tap downloads for ROM hack sources, RetroArch shaders, and a proper game page for downloaded games.
Changes
- Download really downloads. Tapping Download on a ROM hack no longer opens the website for you to find the link. Retra reads the game page, picks the right download button, follows MediaFire, MEGA, Google Drive, GitHub releases or direct links, checks the file is a GB, GBC, GBA, ZIP or patch file, and downloads it in the background. If one link is dead it tries the page's mirror. In a check of every ROM hack in the PokéCoders, PokéHarbor, PokeMundo and Operation iDroid catalogs, 1,427 of 1,607 downloaded a verified file. Pages without a single file (lists like "Best ROM Hacks", forum-only or online-patcher pages), dead links and
.rararchives still open the website. Commercial game catalogs keep opening the website only. - Downloads in progress. Browse → Downloads now shows downloads while they run, with a live progress bar and Pause, then moves them to the history when they finish. The game page shows "Finding the download…" while Retra looks for the link, and progress updates no longer make the page or bar stutter.
- Downloaded games open their game page. Tapping a downloaded catalog game in your Library opens the same page as your other games, with Resume and Recent saves. Import ROM and Download are hidden once a game is installed, including on its Browse page.
- Covers in History. Games added from Browse now show their cover art in the History tab, like on their Library card.
- RetroArch shaders. Settings → Video shader → Import file or Import folder accepts RetroArch shader packs: a
.zipor folder of.slangp/.glslppresets with their shaders, includes and textures, or a single.slang/.glslshader. Multi-pass presets, aliases, history and feedback frames, LUT textures and preset parameters are supported. Slang shaders are compiled with glslang and SPIRV-Cross, the same way RetroArch's GL core driver does it. Of the 3,285 presets in libretro's official slang and glsl packs, 3,180 compiled and ran on Android's GPU driver, including all 234 handheld presets. Large packs get a search box and a Remove button. If a preset cannot run on your GPU, Retra explains why and falls back to the normal renderer.
Install
v1.0.3 is signed with a new release key, so it cannot install over v1.0.2. Before updating:
- In v1.0.2, open Settings → Backup, restore, storage → Create backup and save the
.retrafile somewhere outside the app (Downloads, a PC, or cloud storage you open yourself). - Uninstall v1.0.2.
- Download Retra-v1.0.3.apk and open it on your Android device (Android 8.0 or newer).
- In v1.0.3, choose Restore backup and pick the
.retrafile.
Google Drive backup in v1.0.3 needs the new signing key registered with Retra's Google Cloud project first; use a local .retra backup to move your data. Future updates install over v1.0.3 normally.
Version: 1.0.3 / Android versionCode 454.
Retra v1.0.2
A Browse update: a Downloads tab, more ROM hack sources, and clearer in-app downloads.
Changes
- Smooth 120 Hz scrolling. Scrolling source catalogs, Library and lists is much smoother. On a 120 Hz phone, a 1,000-game source grid went from a median 65 ms per frame (about 16 fps) to 10 ms, with under 3% late frames. Retra no longer applies an invisible zero-strength blur to every card and button, no longer reserves a GPU layer for every cover, and skips drawing off-screen catalog cards. With Translucent on, buttons and search fields no longer re-run an invisible blur every frame (Browse list: 23 ms to 10–11 ms).
- Light mode fixes. Game action tiles (Add to library, Import ROM, Download, Play) keep their outlines and readable labels, and the Browse game title and info lines are no longer smeared by a dark shadow.
- Downloads tab. Browse now has a Downloads tab listing every ROM and patch you downloaded in Retra, newest first, with cover, source, system, size and time. Play a game straight from the list, open its details, or remove entries. Clearing the list never removes games from your Library.
- Pinned source header. On a source page, the title bar and the Popular / Latest / Filter chips stay at the top while you scroll the games, with a thin divider once games scroll beneath them. The Browse and Library tabs no longer let rows show through a strip above them while scrolling, and in Translucent mode the top bars and pinned rows match the page color instead of showing as a darker band.
- Game search from Sources. The Search tab is replaced by Downloads. Tap the search icon on the Sources tab and type at least two letters to search games across every installed source; results appear below the source list.
- Clearer Download button. Website games now show Download instead of "Download on website". It opens the game's page inside Retra; tap the file's download link and supported GB, GBC, GBA, ZIP, IPS, UPS and BPS files go to your Library and the Downloads tab.
- Website sources open in one tap. A source that is browsed on its website (Romhacking.net, Hackdex) shows an Open button instead of an empty page, and a catalog search with no matches offers to search the website instead.
- Retra Sources extension 5.0. The default extension repository replaces Romhack Plaza with Roms Games, PokéHarbor, PokeMundo, PokéCoders, Operation iDroid, Romhacking.net and Hackdex. Update it from Browse → Extensions; this part works on older app versions too.
Install
Download Retra-v1.0.2.apk and open it on your Android device (Android 8.0 or newer). It installs over v1.0.1 and keeps your library, saves and settings.
Version: 1.0.2 / Android versionCode 453.
Retra v1.0.1
A smoothness and polish update for Retra v1.0.0.
Changes
- Edge-to-edge game details. The Information list on Browse game and extension details pages now reaches both sides of the screen, matching the Settings detail pages, while text stays aligned with the section headings.
- Faster first screen. Web fonts load without blocking the first paint. On slow or offline networks the interface appears immediately in the system font and switches to the selected font once it has loaded.
- Lighter interface rendering. The interface WebView no longer renders into an extra full-screen offscreen layer, saving a composite pass and GPU memory on every frame.
- Smoother scroll start and stop. Scroll tracking no longer toggles a document-wide class, which forced a full style recalculation at the start and end of every scroll gesture.
- No pauses when saving interface preferences. Interface preferences are written in the background instead of blocking the interface on a disk write.
- Working update check and Help Center link. The in-app update check and the Help Center link now point to the official
Layfate/Retrarepository.
Install
Download Retra-v1.0.1.apk and open it on your Android device (Android 8.0 or newer). It installs over v1.0.0 and keeps your library, saves and settings.
Note: Retra v1.0.0's built-in update check pointed to a repository that does not exist, so v1.0.0 will not announce this update. Install v1.0.1 manually once; later updates will be detected in the app.
Version: 1.0.1 / Android versionCode 452.
Build and validation
- Source commit:
9569666304975aede6c9e8bb8078accf90c6822c. - Signed with the same production certificate as v1.0.0 (SHA-256
d1864f628012609da578cdca1c044f39949cff4fe28023cb813004ccc23ab7cc), so it upgrades v1.0.0 in place. - APK v2/v3 signatures and 16 KB ZIP alignment verified.
- GitHub Actions: regression and Android compile checks passed.
- Not yet tested on a physical device for this release.
Retra v1.0.0
Retra v1.0.0 is the first public release of the Retra Android emulator, powered by mGBA.
Highlights
- Game Boy, Game Boy Color, and Game Boy Advance emulation.
- Browse tab with extension repositories, website sources, cover artwork, search, and in-app ROM downloads.
- Battery saves, save states, auto-resume, cheats, ROM patches, and portable
.retrabackups. - Customizable on-screen controls with separate portrait and landscape layouts.
- Fast-forward up to 16x, slow motion, shaders, color presets, and high-refresh gameplay presentation.
- Local Link, local Single-Pak/Multiboot, Wi-Fi Remote Link, and Bluetooth Remote Link.
- Optional Google Drive backup and restore.
Download and install
Download Retra-v1.0.0.apk below and open it on your Android device. Android 8.0 or newer is required. The APK includes arm64-v8a, armeabi-v7a, x86, and x86_64 support.
No ROMs or BIOS files are included. Local Single-Pak/Multiboot requires a user-provided 16 KiB GBA BIOS. Wireless Adapter/RFU emulation is not supported.
This first public release uses a dedicated production signing certificate. Existing development/debug installations use a different certificate and cannot be upgraded in place; create and verify a portable backup before switching installations.
Build and validation
- Version:
1.0.0/ Android versionCode451. - Source commit:
25d5b93db671e9c1b0f582b7da07e2618ba13838. - mGBA revision:
543a197582c30364584d773a974d7f991892fa43(verified clean tracked source). - Optimized release APK with R8 and a dedicated 4096-bit RSA release key.
- 456 regression tests, JavaScript syntax checks, release structure validation, JVM unit test, and release lint passed (0 lint errors; existing warnings remain).
- APK v2/v3 signatures and 16 KB ZIP alignment verified.
- Fresh installation and launch verified on an Android 14 emulator.
- Application-context instrumentation test passed on a physical Android device using the debug build. Full physical-device UI, gameplay, multiplayer, and Google Drive end-to-end validation was not completed for this release.
The Google Cloud Android OAuth client must include this release certificate's SHA-1 for Google Drive authorization:
D9:EE:FC:BD:2C:B8:6C:36:9D:BB:0F:77:67:B1:8B:87:4F:4E:A7:49
Retra and mGBA are distributed under MPL-2.0; see the source archive's LICENSE and THIRD_PARTY_NOTICES.md.
GitHub Actions: all regression and Android build checks passed for the identical application source tree.