Changelog v4.0.0 -> v4.1.0
Updates & Improvements
Better Emulator Detection Across All Platforms
- More install locations are now recognized — RetroArch, MAME, and Mednafen are now automatically found in additional common locations on Linux (e.g. Debian/Ubuntu system paths), macOS (including MacPorts), and Windows (Chocolatey).
- Nix package manager support — Emulators installed via Nix on Linux and macOS are now automatically detected.
- MAME Flatpak support — MAME installed as a Flatpak (user or system-wide) is now detected and can be launched directly, matching the existing RetroArch Flatpak support.
- ARM64 Linux core discovery — RetroArch cores on ARM64 Linux systems are now found automatically.
Improved macOS Application Handling
- Smarter .app bundle recognition — Selecting an emulator application on macOS now works reliably, even if the app has an unusual name or internal structure. The app reads the bundle's metadata to find the correct executable.
- Browse button now works for .app bundles — On macOS, the Browse button in settings uses a folder picker so you can properly select
.appapplications. You can also paste a path directly into the text field and press Enter. - Selecting a parent folder works too — If you select a folder like
/Applications/instead of the app itself, the tool will automatically find the emulator app inside it. - Native menu bar now visible on macOS — The application menu bar now appears correctly in the macOS menu bar at the top of the screen.
Other Improvements
- Improved network connection handling — Downloads for RetroArch cores and controller profiles now use a more efficient and consistent connection method.
- Custom install path support — If you point the tool to a custom emulator folder (e.g.
/opt/custom/retroarch/), it will now correctly find the executable inside, including inbin/subdirectories. - RetroArch core search follows the executable — Cores are now found relative to wherever your RetroArch executable is installed, not just in hardcoded system paths.
Bug Fixes
Crash Fixes
- Fixed crash when changing language on macOS and Linux — Switching the app language in Settings no longer crashes the application. The language change is now applied safely in the background.
Emulator Detection & Launching
- Fixed emulators not being found on fresh installs — On a first-time setup where config directories don't exist yet, RetroArch and Mednafen are now detected properly instead of silently failing.
- Fixed custom emulator paths being ignored — Setting a custom path to an emulator folder (instead of the exact executable file) now works correctly on all platforms.
- Fixed macOS apps with different letter casing not being recognized — An app named
retroarchvs.RetroArchinside the bundle no longer causes detection to fail. - Fixed selecting files from inside a .app bundle — If the file picker navigated inside a macOS
.appbundle and you selected an internal file, it was previously rejected. This now works correctly. - Fixed .app bundles in paths with spaces not being detected — Paths like
/Users/name/My Games/RetroArch.appnow work correctly. - Fixed Browse button doing nothing on macOS — Selecting a
.appapplication via the Browse button previously returned empty results silently. This is now resolved.
Controller Profiles & Shortcuts
- Fixed controller profile downloads failing on system-installed RetroArch (Linux) — Downloads now save to the user config directory when the system install location isn't writable.
- Fixed Linux desktop shortcuts with special characters — Shortcut arguments containing spaces or special characters are now properly escaped, preventing launch failures.
UI & Localization
- Fixed MAME and Mednafen settings buttons using wrong labels — The Browse, Auto-Detect, and Clear buttons in MAME and Mednafen settings now show their own correct labels instead of RetroArch-specific ones.
- Fixed broken placeholder in Italian translation — A garbled text placeholder in the Italian core-not-found message has been corrected.