FAQ

FAQ & Troubleshooting

Input & Navigation

Q: Touch requires double-tap to select games in Library

This is expected. In Library, the first tap highlights the game; the second opens Game Details. This mirrors the gamepad behavior where you navigate to a game, then press A to open it.

Home works differently - single tap/press launches directly for quick access to your curated games.

Argosy is designed gamepad-first for handheld devices. Touch works but isn't the primary interaction model.

Q: I can't tell where the cursor is on the Game Details screen

Game Details uses section-based navigation rather than a traditional cursor. The screen is divided into sections (info, screenshots, achievements) and:

• Up/Down moves between sections
• Left/Right moves within the current section

The focus indicator isn't always obvious. Watch the footer hints - they show what actions are available for your current position. This is a known UX gap we're working on.

Downloads & Library

Q: How do I download all games from a platform?

You can't bulk-download directly from a platform view. This is intentional - we want downloads from RomM to be deliberate rather than accidentally syncing hundreds of gigabytes.

Workaround: Create a Collection in RomM with the games you want, sync it to Argosy, then use "Download All" from that collection.

Q: My downloaded games aren't showing up / disappeared

This can happen after updates due to changes in how Argosy detects local files. Try:

1. Go to a game you know is downloaded and press "Download" anyway - this often triggers immediate detection
2. Use Settings > Sync > Sync Library (full sync, not Quick Actions > Resync Platform)
3. Check that your storage path in Settings matches where games are actually stored

If games show in RomM but not Argosy after a full sync, report the issue with your device info.

Q: Download stuck at "Waiting for Storage"

The download is paused, not failed. Free up space on your device and press Resume. Argosy reserves a 50MB buffer to prevent filling your storage completely.

Q: Extraction failed

The downloaded archive is preserved. Try "Retry" first - this often works if it was a temporary issue. If extraction keeps failing, try "Redownload" in case the archive was corrupted during transfer.

Saves & Sync

Q: RetroArch saves syncing to wrong location

RetroArch organizes saves by core (e.g., saves/snes9x/, saves/gambatte/). If you pointed Argosy at a specific core folder instead of the root saves folder, it will only sync that one core.

Fix: Settings > Emulators > RetroArch > Save Path should point to RetroArch/saves/ (the parent folder), not RetroArch/saves/gambatte/ (a specific core).

Q: Sync conflict with "Hardcore" prompt

This appears when you have RetroAchievements hardcore mode enabled but your local save differs from what's on the server. You must choose:

• Keep Hardcore: Discard your local save, use the server save, keep earning achievements
• Downgrade to Casual: Keep your local progress, but achievements won't count for hardcore
• Keep Local: Skip sync for now, play with your local save

This exists because hardcore mode requires save integrity - you can't mix local and server saves.

Q: Saves not syncing for [specific emulator]

Some emulators store saves in private directories that Android prevents other apps from accessing (especially on Android 11+). Argosy attempts to find saves for all emulators, but not all are supported.

Built-in emulation and RetroArch have the best sync support. External emulators vary.

Launching Games

Q: PS2 games fail with "Failed to initialize CDVD" in NetherSX2

This is often a path format issue, especially with external storage (USB drives, SD cards formatted as internal). NetherSX2 expects content URIs but may receive file paths it can't resolve.

Workarounds:

• Try moving ROMs to internal storage
• Use AetherSX2 or the built-in PS2 core if available
• Check for special characters in filenames

Q: ScummVM games won't launch

ScummVM requires games to be registered in its own database before external apps can launch them.

Fix: Open ScummVM directly, go to "Add Game", point it at your game folders. Once ScummVM knows about the game, Argosy can launch it.

Q: PS Vita games open Vita3K but don't start the game

Vita3K requires games to be installed within it first. Argosy passes the game's title ID, but Vita3K needs the actual game data.

Fix: Install the VPK/game in Vita3K directly first. After that, launching from Argosy will work.

Q: Switch games won't launch - missing keys

Switch emulators require encryption keys (prod.keys) that Argosy cannot provide for legal reasons.

Fix: Obtain keys from your own Switch console and place them in the emulator's keys directory. Each emulator has a different location - check that emulator's documentation.

Device-Specific

Q: App doesn't work well on Nvidia Shield / Google TV

Argosy is optimized for handheld devices with horizontal displays and physical controllers. TV interfaces, vertical orientations, and touch-only devices are secondary considerations.

Shield-specific issues like background music selection (#51) are known. TV support may improve over time but isn't the current priority.

Still stuck?

Check open issues to see if your problem is known. If not, create a new issue with:

• Device model and Android version
• Argosy version
• Steps to reproduce

Or ask on Discord for community help.