https://github.com/rommapp/argosy-launcher
A native Android client for RomM for syncing, installing, and launching games on any of your mobile devices
https://github.com/rommapp/argosy-launcher
Last synced: about 1 month ago
JSON representation
A native Android client for RomM for syncing, installing, and launching games on any of your mobile devices
- Host: GitHub
- URL: https://github.com/rommapp/argosy-launcher
- Owner: rommapp
- License: gpl-3.0
- Created: 2025-12-06T10:07:39.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-04-03T22:12:23.000Z (3 months ago)
- Last Synced: 2026-04-04T00:33:00.218Z (3 months ago)
- Language: Kotlin
- Size: 12.4 MB
- Stars: 188
- Watchers: 3
- Forks: 7
- Open Issues: 52
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- stars - argosy-launcher
README
# Argosy Launcher
[](https://github.com/nendotools/argosy-launcher/actions/workflows/build.yml)
[](https://github.com/nendotools/argosy-launcher/releases/latest)
[](https://www.gnu.org/licenses/gpl-3.0)
[](https://developer.android.com/about/versions/oreo)
**A gamepad-first Android launcher for retro gaming handhelds with native RomM integration.**
Sync your entire game library from your self-hosted [RomM](https://github.com/rommapp/romm) server, download games and BIOS files on demand, track your achievements, and play across devices with automatic save sync—all from a controller-native interface designed for Anbernic, Retroid Pocket, Odin, and similar devices.
## Feature Highlights
### Native RomM Client
First-class integration with [RomM](https://github.com/rommapp/romm). Sync your entire library with rich metadata from IGDB—cover art, descriptions, genres, franchises, player counts, and more. Your collection, your server, your handheld.
### Automatic Downloads
Download ROMs and BIOS files directly from your RomM server. Games are automatically sorted by platform. Queue multiple downloads and let Argosy handle the rest.
### Save Sync
Continue playing across devices. Bidirectional save sync with your RomM server keeps your progress in sync automatically. Conflict detection ensures you never lose data.
### RetroAchievements
View your earned achievements and track your progress. Argosy displays achievement data synced from your RomM server, showing what you've unlocked and what's left to earn.
### Collections
Organize your library your way. Create custom collections, or use smart collections like "Top Unplayed", "Recently Added", and "Most Played". Pin your favorites to the home screen for quick access.
### Gamepad-First Design
Built for controllers from the ground up. Navigate your entire library, manage downloads, and launch games without ever touching the screen. Full D-pad, analog stick, and button support.
## Customize Your Experience
### Video Wallpaper
Set YouTube video previews as dynamic backgrounds on the home screen. Watch trailers and gameplay footage while browsing your collection.
### Ambient Audio
Add background music to your browsing experience. Select any audio file to play while navigating your library.
### Display Customization
Fine-tune the visual experience:
- **Themes**: Light, dark, or system-matched
- **Backgrounds**: Blur, saturation, and opacity controls for game art backgrounds
- **Box Art Styles**: Adjust grid density, aspect ratio, and visual effects
- **Sound Effects**: Add audio feedback to navigation with built-in presets or custom sounds
## Smart Emulator Management
### Auto-Detection
Argosy automatically detects installed emulators and assigns them to the appropriate platforms. No manual configuration required for most setups.
### RetroArch Core Selection
When using RetroArch, select specific cores per platform. Argosy manages core selection so you launch with the right emulator every time.
### Multi-Disc Games
PlayStation and other multi-disc games are handled automatically. When you launch a multi-disc game, Argosy presents a disc picker so you can choose where to start.
### Supported Emulators
RetroArch, PPSSPP, DuckStation, AetherSX2, Dolphin, DraStic, melonDS, Mupen64Plus FZ, Pizza Boy, Lime3DS, Azahar, Flycast, Redream, and more. Missing your emulator? [Open an issue](https://github.com/nendotools/argosy-launcher/issues).
## Quick Menu (L3)
Press **L3** (left stick click) anywhere to open the Quick Menu—a fast overlay for discovering games:
- **Search**: Find games across your entire library with fuzzy search
- **Random**: Can't decide what to play? Let Argosy pick for you
- **Most Played**: Jump back into your favorites
- **Top Unplayed**: Highly-rated games you haven't touched yet
- **Recent**: Continue where you left off
- **Favorites**: Quick access to your starred games
## Quick Settings (R3)
Press **R3** (right stick click) anywhere to open Quick Settings—a right-side panel for instant adjustments:
- **Theme**: Switch between light, dark, or system theme
- **Haptics**: Toggle haptic feedback and adjust intensity
- **UI Sounds**: Enable or disable navigation sounds
- **BGM**: Toggle background music on or off
On supported devices (Odin, AYN, Retroid), Quick Settings also includes **Performance Mode** and **Fan Control**.
## More Features
| Feature | Description |
|---------|-------------|
| **Library Filtering** | Browse by genre, player count, franchise, or region |
| **Game Stats** | Track play status, ratings, and community scores |
| **User Ratings** | Rate your games and sync ratings to RomM |
| **Offline Mode** | Full access to downloaded games and cached metadata |
| **Image Caching** | Cache all cover art locally for fast, offline browsing |
| **Steam Games** | Index and launch Steam games installed via GameHub or GameNative |
| **App Launcher** | Quick access to emulators and other apps |
| **In-App Updates** | Update Argosy directly from the app |
| **First-Run Wizard** | Guided setup for new users |
| **Favorites** | Mark games for quick access |
| **Hide Games** | Remove games from view without deleting them |
## Getting Started
1. **Download** the latest APK from [GitHub Releases](https://github.com/nendotools/argosy-launcher/releases/latest)
2. **Install** the APK on your device
3. **Run** Argosy and follow the setup wizard
4. **Connect** to your RomM server (or skip for local-only use)
5. **Sync** your library and start playing
> **New to RomM?** Set up your self-hosted game library at [github.com/rommapp/romm](https://github.com/rommapp/romm)
Updates are handled in-app after initial install.
## Requirements
- Android 8.0 (Oreo) or higher
- Emulators installed for your desired platforms
- A [RomM](https://github.com/rommapp/romm) server (optional, for sync features)
### Target Devices
Argosy is designed for retro gaming handhelds:
- Anbernic (RG35XX, RG556, RG406, etc.)
- Retroid Pocket (RP2+, RP3, RP4, RP5)
- Odin / Odin 2
- AYN handhelds
- Android TV boxes
Works on any Android device, but the gamepad-first interface is optimized for handheld gaming.
## Screenshots
View all screenshots
### Home Screen
### Library
### Library Filtering
### Game Details
### Download Queue
### Settings
### Emulator Autoconfig
### Built-in Updater
## Beta Releases
Subscribe to beta releases for early access to new features. Beta versions may be unstable and introduce breaking changes. Check the [Releases](https://github.com/nendotools/argosy-launcher/releases) page for available beta builds.
## Contributing
Argosy is open source! Contributions, bug reports, and feature requests are welcome.
- [Report a bug](https://github.com/nendotools/argosy-launcher/issues/new)
- [Request a feature](https://github.com/nendotools/argosy-launcher/issues/new)
## License
This project is licensed under the GNU General Public License v3.0 - see the [LICENSE](LICENSE) file for details.