RomM Integration

RomM Integration

RomM is the backbone of Argosy - it provides your game library, metadata, artwork, and cloud saves.

What RomM Provides

• Game library and metadata
• Box art and screenshots
• Platform organization
• Save file synchronization
• Collections synced from RomM

Connection

Configure your RomM server in Settings > Sync > RomM Connection, or during the first-launch wizard. You'll need your server URL (e.g. http://192.168.1.100:8080). On RomM 5.0+ Argosy uses device-managed registration (approve the device by scanning a QR code); older servers use an 8-character pairing code from the RomM web UI.

The connection rides out outages on its own. A failed attempt no longer drops you to disconnected; Argosy keeps retrying on a backoff for a few minutes and reconnects the moment the network returns (for example after wifi re-associates on wake). No re-login is needed after a server restart or a spotty connection.

Library Sync

Argosy syncs your library metadata from RomM. Games appear in your Library but aren't downloaded until you choose to play them.

Resync manually from Settings if your RomM library changes.

Regional releases: when your RomM library has the same game in multiple regions (RomM sibling roms), sync consolidates them into one library entry. An ordered region list (Settings > Sync) picks which copy represents the game; every region stays available as a version you can pick from the game's variant picker. Games you've already downloaded are never swapped out from under you. See Variants.

Platform handling: local and RomM Android games merge into a single Android platform, and FBNeo and MAME arcade folders appear as separate platforms with their own cores and BIOS handling.

Artwork and media

• 3D box art: if your RomM scans include ScreenScraper box media (enable box2d_back and box2d_side in scan settings, then re-scan), game details and the dual-screen showcase render a rotating 3D box. A Cache 3D Box Art toggle lives in Settings > Sync.
• Screenshot uploads: screenshots taken during play upload to your RomM gallery automatically on RomM 5.0+. Disable in Settings > Sync if unwanted.
• Custom cover art: from a game's details you can search SteamGridDB for alternative cover art and set a per-game override, replacing whatever art RomM provided.

Music

On RomM 5.0+ servers, Argosy can browse the music your server hosts for each game. Open Settings > Theme > Music > Browse Server Music to browse tracks by game, stream previews, and download tracks into the background music playlist. The same browser backs the RomM Music option when assigning UI sounds, filtered there to short clips. On older servers these entries are hidden.

Downloaded tracks land in the device's public Music folder under Music/RomM/<Platform>/<Game>/, where other music apps can see them. See Storage and Paths.

Downloading Games

Games download on-demand when you launch them, or batch-download from Collections. Monitor progress in the Downloads section.

Offline Use

Once games are downloaded, they work without a RomM connection. Local changes (saves, ratings, favorites) queue and sync when reconnected.