🎮 eOr

Your retro library, beautifully organized.

eOr — short for emulation, organized — is a fast, gorgeous game launcher for Android handhelds and phones. Point it at your ROMs, let it pull box art, screenshots and video previews automatically, and launch straight into your games — all wrapped in a polished, controller-first interface.

• 🎨 Looks the part — a fanned box-art hero over a colourful system carousel, glossy tiles and playful bounce animations. Choose Light or Dark from a visual theme picker, and sort your consoles however you like (release date, brand, library size and more).
• 🖼️ Art that fills itself in — batch-scrape box art, screenshots, wheel logos and video previews from ScreenScraper.fr, with free libretro thumbnails and LaunchBox as no-account fallbacks. Already have an ES-DE library? Import its downloaded_media folder instead. Re-scraping skips anything that's already complete.
• 🎮 Plays everything — auto-detects your installed emulators and launches games straight into them, with per-core selection where it applies, across 30+ systems spanning generations of retro and modern consoles.
• 🕹️ Built for a controller — full D-pad and bumper navigation, hold-to-scroll, and your place is remembered as you move between systems, games and detail screens.
• 🖥️🖥️ Dual-screen Support — on dual screen handhelds, eOr spreads across both panels following your Light/Dark theme. No additional setup required, it's detected automatically.
• 🏆 RetroAchievements — sign in with your username and password to see your points, rank and recently-played progress right inside the launcher.
• 🔄 Save Sync — keep your emulator saves in sync across devices with peer-to-peer syncing (powered by Syncthing) and one-QR-code device pairing. eOr shows which of your installed emulators are ready to sync, with optional Wi-Fi-only and charging-only conditions.
• 👥 Friends — see what your friends are playing and their RetroAchievements score, right on the home screen. Add friends by sharing a link or tapping a nearby player on the same Wi-Fi — it's fully peer-to-peer with no account, no login, and nothing stored online. Turn the whole feature off any time with a single toggle.
• 📱 More than ROMs — bring in your installed Android games and Steam / PC streaming launchers alongside your retro collection.
• ⚡ Fast & tidy — a 512 MB artwork cache, instant navigation, and a scanner that keeps your library in sync as ROMs come and go.
• ➡️ Weekly Releases - with v2 we are moving to a weekly release model so every weekend you will get the most up to date version of eOr

Game library	Game detail & launch
Dark mode	RetroAchievements
Visual theme picker	Save Sync
Friends	Add a friend

If you grew up with it, eOr probably runs it. 30+ systems are recognised out of the box — the 8-bit classics, the 16-bit golden age, modern handhelds, HD consoles and arcade. Drop your ROMs into folders named after each system and the scanner sorts everything automatically by folder name and file extension.

Play all the platforms you love — no spreadsheet required.

eOr launches straight into the emulators you already use. Installed emulators are auto-detected and assigned per platform — RetroArch (with per-core selection) for the universal stuff, and your favourite standalones for everything else. Anything we don't recognise can be added in seconds via Settings → Configure Emulators with a custom package name.

• An Android device running Android 8.0 (Oreo) or newer
• Enough free storage for your ROMs and downloaded artwork (a 512 MB artwork cache is used by default)
• Permission to install apps from unknown sources, since eOr is distributed as an APK outside the Play Store
• The emulator apps you want to launch your games in

On first launch the app opens Settings automatically. Complete these steps before scanning:

1. Set your ROM folder — tap the folder icon next to "ROM Folder" and select the directory where your ROMs live (e.g. /sdcard/ROMs). The scanner expects subfolders named after platforms (e.g. ROMs/SNES/, ROMs/PS1/).

2. Configure emulators — tap Configure Emulators. For each platform, choose which installed emulator to use. If using RetroArch, also set the core filename (e.g. snes9x_libretro.so).

3. Add ScreenScraper credentials — sign up for a free account at screenscraper.fr, then enter your username and password under the ScreenScraper section. Tap Validate to confirm they work.

4. Scan ROMs — tap Rescan ROMs (or go back to Home; a scan runs automatically on first launch if a ROM folder is set). The scanner hashes the first 8 MB of each file for better ScreenScraper matching.

5. Scrape artwork — tap Scrape All to fetch box art, screenshots, and video previews for your library. Progress is shown in real time. The scraper respects ScreenScraper's rate limit (1 request per 1.2 seconds) automatically.

app/src/main/java/com/gamelaunch/frontend/
├── data/
│   ├── db/                  # Room database, DAOs, entities
│   ├── network/             # ScreenScraper Retrofit API + DTOs
│   ├── preferences/         # DataStore wrapper
│   └── repository/          # Repository implementations
├── domain/
│   ├── model/               # Pure Kotlin data models
│   ├── platform/            # Platform definitions + detector
│   ├── repository/          # Repository interfaces
│   └── usecase/             # ScanRoms, ScrapeGame, BatchScrape, LaunchGame
├── launcher/                # EmulatorLauncher + PackageManagerHelper
├── ui/
│   ├── component/           # VideoPlayer, AsyncGameArtwork, PlatformTabRow
│   ├── navigation/          # NavGraph + Screen sealed class
│   ├── screen/              # Home, GameDetail, Scan, Scrape, Settings
│   └── theme/
│       ├── carousel/        # Full-screen carousel layout
│       └── grid/            # Grid layout
└── di/                      # Hilt DI modules

Pull requests are welcome. For major changes, open an issue first to discuss what you'd like to change.

When adding a new platform, add an entry to PlatformDefinitions.kt with the correct ScreenScraper systemeid.

• System console icons are from retro-game-console-icons by KyleBing, licensed under GPL-3.0. Thank you!

eOr builds on the work of these projects and communities:

• ScreenScraper — the community-run game database that powers eOr's metadata and artwork scraping. Thanks to the ScreenScraper team and its contributors.
• Syncthing — the open-source, continuous file-synchronization project behind eOr's save-sync detection. Thanks to the Syncthing project and its maintainers.
• RetroAchievements — the achievement platform and API that eOr surfaces game progress from. Thanks to the RetroAchievements team and community.

Thanks to everyone who has helped improve eOr:

• @aarvsn — database cleanup, emulator-mapping, and scanner fixes (#41); Xbox 360 (Xenia) integration (#56)
• @picodspi — Eden support — FileProvider content-URI launching plus update/DLC/firmware scan filtering (#68); NSP artwork — extract and import artwork embedded in Switch NSP files (#72); Home-launcher mode — run eOr as the device home app, with Home returning to the library (#76); Locked Mode — PIN-protected kiosk mode with an app allowlist and per-game availability (#79)

• Ban at RetroHandhelds.gg — for the write-up, eOr Launcher Aims to Be An Organized Frontend for Emulation. Thank you!

For those with questions about AI. I am a technologist, designer, engineer, and creator by trade. I work on MANY projects at once (luckily on this one I have wonderful contributors who help) and yes I use AI to do a lot of the work on my hobby projects, like this one. There simply isn't enough "human power" to work on everything at once. I use AI so I can offer quality experiences I love to the people I love completely free, completely open source, and with no ads or money making schemes ever. I will never ask for anything from any user, not even a coffee tip. I simply like retro gaming and wanted to make a launcher that showed my appreciation for that community.

I am sorry if the use of AI turns you away but I will keep improving this app either way. Just for the love of the retro game!! <3

Thank you to all of our users, git contributors, and to gamers everywhere for not only helping to inspire and create this app but also this amazing community! All of the love to you all <3

MIT