Cross Platform Notes

Cross-Platform Notes

Windows

• Fully supported, primary development platform
• Emulators install to %APPDATA%\Freegosy\emulators\
• 7-Zip bundled as thirdparty/7zr.exe for .7z extraction
• Windows native game launching supported with auto-exe detection
• Xenia Canary (Xbox 360) is Windows-only
• Windows games are folder-based: findMainRomInFolder() returns the folder path, not a file
• .exe detection skips __MACOSX, _CommonRedist, ._ prefixed files, and vcredist/setup/uninstall binaries
• .bat/.cmd files are supported as launch executables (via cmd.exe /c)

macOS

• ARM64 (Apple Silicon) and Intel both supported since v0.2.1
• Emulators install to ~/Library/Application Support/Freegosy/emulators/
• .app bundles are auto-detected recursively after extraction
• Versioned app names (e.g. PCSX2-v2.6.3.app) are automatically renamed to canonical names (PCSX2.app) for stable detection
• Quarantine attributes are stripped automatically (xattr -rd com.apple.quarantine)
• Apps are deep-signed automatically (codesign --force --deep --sign -)
• RPCS3: the ARM native build has a regression for some games; use the x86 build via Rosetta 2 as a workaround
• Azahar: if the Libretro core is detected instead of the standalone app, Freegosy shows an error suggesting to switch to RetroArch in Settings
• PlayStation controllers on macOS: recognized as "Sony Interactive Entertainment Wireless Controller" (IOKit name)

Linux

• Full support via PlatformInfo abstraction (no more dart:io Platform in services)
• EmuDeck and RetroDECK environment strategies for automatic path detection
• Native Linux strategy as fallback for non-EmuDeck setups
• Proton/Steam prefix path resolution for native PC games via LinuxNativeGameService
• AppImage detection: searches ~/Applications and ~/AppImages with fuzzy name matching
• Flatpak support via kEmulatorFlatpakPackages database
• PlayStation controllers on Linux: recognized via evdev name

Android

• Planned for a future release
• Will support deep links to Play Store / Epic Games for game downloads
• Save sync architecture already cross-platform ready