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.

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.

Region priority: when your RomM library has the same game in multiple regions, an ordered region list (Settings > Sync) picks which copy represents the game; the rest stay accessible as variants. Games you've already downloaded are never swapped out from under you.

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.

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.