Support This Project

All projects made with passion 💙

Freegosy

Website: https://abduznik.github.io/Freegosy/

A cross-platform Flutter app for browsing your RomM library, downloading ROMs, and launching games directly in emulators—all from one intuitive interface.

Watch the Feature Walkthrough on YouTube

Join our Discord community to chat, get help, and be the first to test new releases!

The main menu showcasing the intuitive game card interface.

Detailed game view with metadata, screenshots, and quick actions.

Background & Vision

Freegosy (Free as in "Free for all OS") is the successor to Wingosy. While Wingosy was focused on Windows, Freegosy is built from the ground up using Flutter to provide a unified frontend for all major platforms.

The original inspiration for these projects was Argosy, the native Android app for RomM built in Kotlin. Freegosy aims to bring that same native experience to desktop and beyond, ensuring a seamless, ease-of-use interface for accessing your RomM collection on any device.

Support the Project

Freegosy is a solo passion project — built and maintained in my spare time, with AI tools I pay for out of pocket. If it saves you time or makes your RomM setup better, a small contribution genuinely helps keep it going.

No pressure at all — the app is and will always be free.

Current Features (v0.6.1)

• New in 0.6.1:

  • Library list layout (one row per game with rating, status and last played) next to the cover grid, and a cloud badge on games whose saves have synced.
  • Play time on the game page, free-space check before big downloads, and .rar games extracted automatically.
  • RetroAchievements sign-in now also covers PCSX2, PPSSPP and Dolphin.
  • RetroArch save-state sync and Resume Game, .chd serials read natively (no chdman needed), and RetroArch's PS2 core (LRPS2) saves.
  • Nightly update channel, a Skip this version button, and a Linux/NVIDIA/Wayland fix for Dolphin.
  • Status and rating now save correctly on RomM 4.9+, and a startup crash on Linux (inotify limit) is fixed.
  • See the changelog for everything.

• Native Multi-Platform Support: Full support for macOS (ARM64/Intel), Windows, and Linux (including Steam Deck/EmuDeck and RetroDECK integration).

• Enhanced Offline Mode: Persistent metadata caching for browsing and launching your collection without a connection.
• RomM Integration:
  • Browse and filter your entire library with server-side pagination.
  • Instant "Downloaded" games filter with background deep collection scanning.
  • Download ROMs directly via HTTP with real-time progress tracking.
  • Personal game properties support (rating, status, completion).
  • New: Full RomM 4.9 support — per-device save sync, play session tracking.
• Advanced Emulator Management:
  • Download, update, and uninstall emulators directly from Settings.
  • Automatic extraction of .zip, .7z, .dmg, .tar.gz, .tar.xz, and .AppImage.
  • Smart binary detection and canonical naming across all platforms.
  • Dynamic architecture selection for RPCS3 on macOS (ARM64 vs x64).
  • Linux Environment Strategies (Default, EmuDeck, RetroDECK) with automatic path detection.
• RetroArch Core Management:
  • 197 libretro cores with searchable platform browser.
  • Per-platform default core selection (Settings → RetroArch Cores).
  • Per-game core override (launch-time picker or long-press in Platform Manager).
  • Platform Manager: choose between standalone emulator or RetroArch core per platform.
  • Favorite cores pinning for quick access.
• BIOS Management: Fetch and download BIOS files directly from RomM and automatically place them in the correct directory for each emulator.
• Save Sync:
  • Bidirectional local-to-cloud save synchronization with RomM.
  • Local Backup History (create instant restore points before experimenting).
  • Serial Background Sync Queue (offline backups silently push to RomM automatically when you reconnect).
  • Optimized for EmuDeck's platform-specific save structure.
  • New: Per-device save isolation on RomM 4.9+ (saves tagged to your device, no cross-device conflicts).
  • New: Play session tracking — game sessions automatically recorded to RomM 4.9+.
  • New: PCSX2 per-game folder saves (saves/{Serial}/) supported alongside legacy memcards.
  • New: Dolphin GameCube saves now correctly upload a single .gci (no more backup dumps or unrelated games).
  • New: All strategies respect a 2-second session-start grace window to prevent missing saves written at launch.
  • New in 0.6.0: Save-state sync and Resume Game for PCSX2 and DuckStation (opt-in "Sync save states"), with state thumbnails.
  • New in 0.6.0: PS1/PS2 memory cards interoperate across emulators: DuckStation cards follow its Memory Card Type setting and work with RetroArch's PS1 cores; LRPS2 (RetroArch PS2) and PCSX2 file memory cards sync one game's saves at a time.
  • New in 0.6.0: RetroArch saves now land in the launching core's own folder and never pick up another game's save; saves on RomM are tagged with the emulator that made them.
• Refined UI/UX:
  • Visual-First Grid: Interactive game cards with detailed metadata.
  • Recently Played: Quick access to your latest games.
  • Screenshot Gallery: Interactive, zoomable screenshot viewer.
  • Multi-Disc Support: Integrated picker for multi-file games.
  • New in 0.6.0: Fullscreen toggle (F11, "Start in fullscreen" setting, or --fullscreen) and a cover size slider in the library top bar.

• Controller Support:

  • New: Polarity-encoded axis keys (left_x+ / left_x-) for full analog stick and hat switch mapping.
  • New: SDL GameControllerDB hat switch format (h0.1, h0.2, etc.) fully parsed for auto-mapping.
  • New: Reset controller mapping button to clear a broken custom profile.
  • New: Save button disabled when sniff wizard produces an empty mapping.

• RetroAchievements: Connect your account in Settings; unlocks are matched with RomM and RetroArch logs in automatically.

• More platforms out of the box: ScummVM, Sega 32X (PicoDrive), TurboGrafx-CD / PC Engine CD (Beetle PCE), and RomM's alternate platform slugs are now recognised.
• Headless mode: Scriptable list / download / launch without a window (see below).

Headless Mode (early preview)

Freegosy can run without opening a window — useful for scripting a launch/sync check, or driving it from an agent/CI. This is a new, actively-tested feature; feedback welcome.

freegosy.exe --headless list [--search=TERM] [--platform=SLUG_OR_ID] [--limit=N] [--json]
         [--genre=A,B] [--region=A,B] [--language=A,B] [--franchise=A,B] [--players=1,2]
         [--sort=name|added|release|rating|played] [--desc|--asc] [--preset=recent|continue|top-unplayed|top-rated|most-played]
freegosy.exe --headless random [same filters as list] [--json]
freegosy.exe --headless filters [list | save NAME [filters] | delete NAME]
freegosy.exe --headless download (--game-id=ID | --name=TERM) [--all-files] [--json]
freegosy.exe --headless launch (--game-id=ID | --name=TERM) [--emulator=ID] [--core=ID] [--timeout=SECONDS] [--json]
freegosy.exe --headless interactive
freegosy.exe --headless                 (same as interactive)

• list/download/launch accept --game-id (RomM game ID) or --name (best match by title; ambiguous matches are listed instead of guessing).
• launch waits for the emulator to exit, then runs the same save-push/backup pipeline as launching from the UI, and reports the result (pass/fail, sync status, backup path) as JSON with --json or human-readable text otherwise.
• --timeout force-terminates the emulator after N seconds instead of waiting for you to close it — handy for automated checks. Some emulators (e.g. MelonDS) manage the process internally until it exits, so the timeout only takes effect once a process handle becomes available.
• Inspection commands (all take --json; log output goes to stderr so stdout is only the result):

freegosy --headless doctor                      health check: RomM, folders, free space, emulators, umu-run/wine/Proton
freegosy --headless platforms                   platforms with id, slug, game count and the emulator that runs them
freegosy --headless emulators                   every emulator: installed or missing, path, platforms, save/state sync
freegosy --headless info --name="Game"          metadata, your rating/status, on-disk path, emulator, play time
freegosy --headless playtime [--limit=N]        games ranked by play time measured on this computer
freegosy --headless saves [check|push|pull|backups] --game-id=ID   save sync, from the CLI
freegosy --headless values genres               the exact genre/franchise/player-count spellings the server knows
freegosy --headless filters list|save|delete    saved filter sets
freegosy --headless launch --game-id=ID --dry-run [--runner=umu|wine] [--proton=installed|PATH|GE-Proton]

--platform= accepts an id, a slug (snes) or a platform name. - Credentials are reused from the account already configured in the app (server URL, username, password/API key/token) — log in once via the normal UI first. - Exit codes: 0 success, 1 launch/sync failed, 2 invalid arguments or game/config not found.

Platform / Emulator Status

Per-OS Notes: - macOS (ARM64/Intel): RetroArch, DuckStation, Ryujinx, Eden, mGBA all verified. App bundle path resolution handles .app package structure. Ares save path: ~/Library/Application Support/ares/. - Windows: Same emulator support. DuckStation portable mode auto-configured via portable.txt. RetroArch config file resolution via APPDATA. Ares portable (settings next to exe) or %LOCALAPPDATA%/ares/. - Linux (Steam Deck / EmuDeck / RetroDECK): RetroArch, DuckStation, Dolphin, PPSSPP, PCSX2 all supported via EmuDeck/RetroDECK save structure presets. Ares save path: ~/.local/share/ares/.

Help wanted — if you're using an emulator marked 🔴 or 🟡 and can confirm compatibility, please report your experience!

Calling All Testers!

I am currently searching for testers on macOS, Windows, and Linux (Steam Deck) to help polish the experience.

• Future Plans: Android support is next for a truly unified app experience.
• Get Involved: If you're interested in testing an early release, reach out via GitHub or join the community discussions.

Community Reviews

About RomM

Freegosy is built to complement RomM, a modern ROM manager. It connects to your RomM instance to provide a lightweight, portable way to access and play your games.

Installation

Arch Linux

A PKGBUILD that repackages the release AppImage lives in packaging/arch. The release workflow keeps its version and checksum current.

git clone https://github.com/abduznik/Freegosy.git
cd Freegosy/packaging/arch
makepkg -si

Nix / NixOS

Freegosy provides a flake for Nix-based systems. Add it as an input in your flake:

{
  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
    freegosy.url = "github:abduznik/Freegosy";
  };

  outputs = { self, nixpkgs, freegosy }: {
    # Use in your configuration
  };
}

Or run directly without installing:

nix run github:abduznik/Freegosy

Other Platforms

Download the latest release for your platform from the Releases page:

• Windows: .exe installer
• macOS: .dmg disk image
• Linux: AppImage (.AppImage) or tarball (.tar.gz)

Windows Defender false positive (v0.5.10 and later)

Windows Defender may flag freegosy.exe as Wacatac.B!ml. This is a false positive. Freegosy is fully open source — you can audit every line of code in this repository. The warning is triggered because the executable is not code-signed and new release hashes start with zero download history, which causes Microsoft's ML model to flag them automatically. The detection clears on its own as more users download the release. If you want to verify the file before running it, check that the SHA-256 hash matches the one listed on the Releases page.