A screenshot of mGBA 0.10.5. Image by ItsTheGuy 2025, via Wikimedia Commons (CC BY-SA 4.0).

Beetle GBA

GAME BOY ADVANCE EMULATOR CORE

Beetle GBA

Beetle GBA is a Libretro core that ports the Mednafen/VisualBoyAdvance lineage to the libretro API to run Game Boy Advance software inside frontends such as RetroArch.

Jump to download ↓Jump to setup guide ↓

A screenshot of mGBA 0.10.5. Image by ItsTheGuy 2025, via Wikimedia Commons (CC BY-SA 4.0).

Game Boy AdvancePRIMARY SYSTEM

2000sPROJECT BEGAN

Open sourcePROJECT MODEL

WHY IT MATTERS

Why Beetle GBA exists

Beetle GBA provides a libretro-compatible GBA core based on the Mednafen/VBA family so users of RetroArch and other libretro frontends can run GBA software using that codebase and its features in a core form.

BEST FOR

When to use Beetle GBA

Use Beetle GBA when you want a libretro core derived from the Mednafen/VBA codepath and prefer the features or behavior of that implementation inside a libretro frontend. For many users today, mGBA is an alternative worth comparing; Beetle GBA remains available for users who prefer its particular compatibility/behavior profile.

Gameplay from Metroid Fusion on Game Boy Advance.

The people behind Beetle GBA

History and lineage

The Beetle GBA libretro core is a Libretro-hosted port of the Mednafen/VisualBoyAdvance family adapted to the libretro API. Its repository (libretro/beetle-gba-libretro) documents that it is a standalone port of Mednafen GBA and notes the project licensing as GPL-2.0. Over time the libretro ecosystem added multiple GBA cores (mGBA, gpSP, VBA-M, Beetle GBA and others); community guidance and official docs list Beetle GBA alongside those alternatives. The core is maintained in the libretro GitHub organization and distributed as a libretro core; it is not a packaged commercial product and does not include copyrighted BIOS or game content.

What Beetle GBA supports

Game Boy Advance (ROM image formats used by RetroArch/cores: .gba, commonly inside .zip)
Runs as a libretro core inside RetroArch and other libretro frontends
Platforms supported where RetroArch builds are available (Windows, Linux, macOS, Android, and other RetroArch-supported OSes)
Uses GPLv2 licensing (project source under GPL-2.0 in the repository)

Download and availability

OFFICIAL DOWNLOADS

Get Beetle GBA

Official core binaries are normally distributed through the RetroArch/Core Downloader and the libretro core download guidance. The libretro documentation lists Beetle GBA in the core list and provides the core documentation page. For source or self-build, the libretro beetle-gba-libretro repository contains the source and build artifacts.

Get Beetle GBA ↗

DOCUMENTATION

Official documentation

Read the official configuration, compatibility, and troubleshooting material before changing advanced options.

Read official documentation ↗

Broken or missing download? Emulator projects move and official links sometimes change. Please contact Retro Replay so the source can be verified and updated.

Beetle GBA setup guide

Setup note: This setup guide explains how to obtain and run the Beetle GBA libretro core in RetroArch (or another libretro frontend), how to configure required files (BIOS if necessary), and practical tips for getting the core working on common platforms.

1) Obtain RetroArch (frontend): Install RetroArch for your platform using the official RetroArch distribution channels (RetroArch website or platform package managers). RetroArch is the standard libretro frontend used with Beetle GBA; the core will normally be downloaded into RetroArch's cores directory.
2) Acquire the Beetle GBA core: Open RetroArch, go to Online Updater → Core Updater (or Cores → Download Core), and find 'Beetle GBA' in the list. Download the core from the frontend. If you prefer building from source, clone the libretro/beetle-gba-libretro repository and follow its Makefile/README build instructions to produce a libretro .so/.dll/.dylib core.
3) ROM files and legal note: Prepare Game Boy Advance ROM images you legally own (common extension .gba). Do not expect the core or RetroArch distribution to include commercial games or BIOS images. Place your ROMs in a folder RetroArch can access; use RetroArch's 'Load Content' menu to run them.
4) BIOS and firmware considerations: Check the libretro core documentation and RetroArch BIOS documentation for whether Beetle GBA needs a GBA BIOS dump for certain behavior. The libretro docs provide a BIOS information page and core-specific notes; only use BIOS files you legally dumped from hardware. If the core can run without a BIOS, behavior may differ from hardware in edge cases.
5) Core options and performance: Open Quick Menu → Options while a ROM is loaded to view Beetle GBA core options exposed to RetroArch (rendering, audio, rewinding, save behavior, etc.). Adjust video driver and audio latency in RetroArch settings if you see audio crackle or frame pacing issues. If performance is a problem on your device, compare Beetle GBA with alternative GBA cores (mGBA, gpSP) to find the best fit for your hardware.
6) Save files and compatibility: RetroArch manages save RAM and save states through the libretro frontend. Note that core compatibility with the libretro save interface can differ between cores—refer to the libretro compatibility pages for details about which cores autosave or require graceful core shutdown to persist saves. When switching cores, use the correct save file formats or export/import saves as needed.
7) Building from source (optional): If you need a custom build, checkout the libretro/beetle-gba-libretro repository. Follow the repository's Makefile and any platform-specific jni or build folders. The repository includes mednafen subcomponents and libretro glue. Build toolchains will vary by platform; ensure you have the appropriate compiler/toolchain for Windows (MSYS/MinGW or Visual Studio cross-build), Linux GCC/Clang, macOS toolchain, or Android NDK for Android builds.
8) Troubleshooting and switching cores: If you encounter audio glitches, frame pacing issues, or missing features, consult the libretro documentation and the repository issues/discussions. Because multiple GBA cores exist, trying mGBA or gpSP may resolve platform-specific problems. Community forums and the core repository issue tracker are helpful for specific bugs.

Software reminder: Beetle GBA is distributed as source (GPL-2.0) and as a libretro core; it does not contain commercial ROMs, BIOS, or proprietary firmware. Obtain ROMs and BIOS files only from legal sources (your own hardware dumps).