RetroArch LaunchBox Integration Plugin

Written By AstroBob

Last updated 1 day ago

RetroArch is one of the most fully featured emulator integrations available in LaunchBox. As a multi-system emulator built around cores, RetroArch can vary widely depending on the platforms and cores you use, and the LaunchBox plugin is designed to simplify as much of that setup as possible.

With this plugin, LaunchBox can download and configure RetroArch, keep it up to date, manage dependency files such as BIOS files, sign in to RetroAchievements, and download bezel artwork through The Bezel Project.

📊 Capabilities Matrix

Capability

Availability

Notes

Download & Configure

✅

Downloads the app and matching cores from official sources

Update and Reinstall

✅

Checks versions and supports updating or full reinstall

LaunchBox Emulator Profile

✅

Auto-created with associated platforms and common defaults

Portable Mode

N/A

RetroArch already runs in portable mode by default

Dependency Files

✅

BIOS and dependency file checks with status and actions

RetroAchievements Integration

✅

Credentials, Hardcore Mode, and sync status supported

Automatic Controller Configuration

✅

Most common controllers are recognized without additional setup

Bezel Download Integration

✅

Supports bezel downloads through The Bezel Project

⬇️ Download and Configure

The plugin can automatically download the correct version of RetroArch directly from official sources. Two archives are downloaded during setup: one for the main application and one containing the matching cores for that release.

  • The main app is extracted to LaunchBox\Emulators\RetroArch

  • The cores package is extracted to LaunchBox\Emulators\RetroArch\cores

This gives users a clean and consistent starting point without requiring a separate RetroArch setup process.

🔄 Update and Reinstall

LaunchBox checks which version of RetroArch is installed and compares it with the latest available release. This status is shown when you open Tools > Manage > Emulators.

  • If the installed version is current, LaunchBox shows it as up to date

  • If an update is available, you can open the emulator entry and use the Update button

Updating downloads the latest RetroArch files and matching cores while preserving existing configuration files where possible.

If you want to start over from a clean state, reinstalling clears the RetroArch folder before extracting the fresh files. This also removes custom files and configuration changes, so it should be treated as a reset.

⚙️ LaunchBox Emulator Profile

The RetroArch plugin creates a ready-to-use emulator profile in LaunchBox with common defaults already in place. It also associates supported platforms so RetroArch can be used immediately after installation for the systems it supports.

Because RetroArch is a multi-system emulator, the exact behavior still depends on core selection and platform setup, but the LaunchBox side of the configuration is handled automatically.

📁 Portable Mode

RetroArch already stores its configuration and user data within its own folder structure, so no additional portable mode setup is needed. In practice, this means the emulator already behaves as a portable installation inside your LaunchBox setup.

If you move LaunchBox to another system, RetroArch moves with it along with its configuration.

🧩 Dependency Files

The plugin helps manage BIOS and other dependency files required by specific RetroArch cores.

In LaunchBox, the dependency files interface can:

  • List required files for supported platforms and cores

  • Show whether files are present, missing, or mismatched

  • Identify expected filenames and target locations

  • Support grouped requirements where one of several files is acceptable

Users can browse to the correct location or select a file and let LaunchBox place it in the proper folder. For multi-platform cores, LaunchBox can also show different dependency requirements depending on the selected platform.

🏆 RetroAchievements Integration

LaunchBox provides direct RetroAchievements integration for RetroArch. Users can enter their RetroAchievements username and token once in LaunchBox, and the plugin handles writing the appropriate settings into RetroArch.

This includes:

  • Syncing credentials

  • Enabling or disabling Hardcore Mode

  • Showing whether the current RetroArch settings match LaunchBox

This allows users to manage RetroAchievements through LaunchBox rather than signing in separately inside RetroArch.

🎮 Automatic Controller Configuration

RetroArch recognizes most common controllers right out of the box, so in most cases no additional controller configuration should be required.

Users may still choose to customize button mappings or per-core behavior, but for a typical setup, RetroArch handles controller detection automatically and is generally ready to use on first launch.

🖼️ Bezel Download Integration

RetroArch supports bezel downloads through The Bezel Project. During supported imports, LaunchBox can download and apply bezel artwork for use with RetroArch.

This includes different bezel styles depending on availability, such as:

  • Theme bezels

  • System bezels

  • Fallback platform bezels

RetroArch is one of the official emulator integrations that supports this feature.