Emulator Management

Emulator Management

Downloading an Emulator

• Go to Settings → Emulators
• The list shows only emulators supported on your current OS
• Tap the download button next to any emulator
• Freegosy fetches the latest release from GitHub or the official source automatically
• Progress is shown in real-time

Updating an Emulator

• A blue update button appears next to any emulator that has a newer version available
• Tap it to download and replace the current installation

Uninstalling an Emulator

• Tap the red trash button next to any installed emulator
• This removes the emulator binary and its local files from Freegosy's managed directory
• Your saves and ROMs are NOT affected

Where Emulators are Stored

• Windows: %APPDATA%\Freegosy\emulators{emulatorId}\
• macOS: ~/Library/Application Support/Freegosy/emulators/{emulatorId}/
• Emulators are installed in portable mode where possible (settings travel with the binary)

RetroArch Cores

• Freegosy automatically downloads the correct RetroArch core for each platform
• Cores are fetched from the libretro nightly buildbot
• If a core is missing, launching a game shows an error with the exact core path needed
• You can manually place cores in {retroarch_dir}/cores/ as a fallback

Emulator Conflicts

• When two emulators support the same platform (e.g. RetroArch and mGBA both handle GBA), a conflict icon appears in Settings
• Tap it to choose your preferred emulator for that platform
• Your preference is saved and applied to save sync as well