Skip to content

Latest commit

 

History

History
155 lines (109 loc) · 6.17 KB

File metadata and controls

155 lines (109 loc) · 6.17 KB

🎮 R-Shop

The fastest way to turn your retro library into a console-like experience on Android.

R-Shop is a controller-first game manager for Android handhelds and TVs. Connect your local folders, RomM server, or network shares, and browse your collection through a polished UI that feels closer to an eShop than a file browser.

R-Shop Console Overview

Download latest APK Get it on Obtainium Visit website Join Discord

Version Platform License GitHub stars


Why R-Shop?

Most retro setups are powerful, but they still feel like setups.

R-Shop focuses on the part people actually care about: getting into their games fast, with a UI that feels good on a handheld, a controller, or the couch.

It removes as much setup friction as possible:

  • QR pairing for RomM so users can connect in seconds
  • Automatic source and system mapping using known naming conventions
  • Automatic metadata and artwork with no account required
  • Automatic RetroAchievements matching when available
  • Manual overrides only when needed, not as the default path

The goal is simple: scan, connect, browse, play.


What makes it different

🎮 Console-like by design

Built around controllers first, not bolted on later. D-pad navigation, focus handling, layout decisions, and game flow are designed to feel native on Android handhelds and TV setups.

⚡ Fast setup, low friction

R-Shop is at its best when it makes complicated retro-library setup feel trivial. Local folders, RomM, SMB, FTP, and Web sources can all feed the same experience.

🧠 Smart defaults

Systems are mapped automatically where possible. RomM sources map automatically. Metadata comes in automatically. RetroAchievements can match automatically. You step in only when something needs correction.

🌐 Multi-source library, one front end

Merge games from multiple providers into a single clean library instead of juggling separate tools, launchers, or source-specific views.


Features

  • Controller-first UI for Android handhelds and TV devices
  • Unified Sources screen for RomM, SMB, FTP, Web, and local libraries
  • QR-based RomM pairing with token auth and re-pair support
  • Automatic system mapping for local and network libraries
  • Automatic metadata and cover art with no manual login required
  • RetroAchievements integration with game matching, progress, and badges
  • Library-wide browsing with Installed, Favorites, search, and zoom controls
  • Background-ready download queue with live progress on cards and buttons
  • Per-card source indicators showing where each game is available
  • One-question onboarding that adapts to how users store their ROMs

Screenshots

Console overview ROM list

Game detail screen Download queue

Source setup


Supported systems

R-Shop supports 66 systems with icons, RetroAchievements integration, and automatic folder mapping.

Highlights include:

  • Nintendo: NES, SNES, N64, GameCube, Wii, Wii U, Switch, GB, GBC, GBA, NDS, 3DS, DSi, Virtual Boy, FDS, Game & Watch
  • Sony: PlayStation, PS2, PS3, PSP, PS Vita
  • Sega: Master System, Mega Drive, Game Gear, Sega CD, 32X, Saturn, Dreamcast, SG-1000
  • Atari: 2600, 5200, 7800, Lynx, Jaguar, Jaguar CD, ST
  • NEC: TurboGrafx-16, TurboGrafx-CD, PC-FX
  • SNK: Neo Geo Pocket, Neo Geo CD
  • Others: WonderSwan, ColecoVision, Intellivision, Vectrex, MSX, Amstrad CPC, Commodore 64, Amiga, ZX Spectrum, Arcade, DOS, and more

Installation

Obtainium

The easiest way to install and stay up to date:

Get it on Obtainium

Manual APK

Download the latest APK from the Releases page.


Getting started

  1. Install R-Shop
  2. Choose how your library is stored
  3. Connect a local folder, network source, or RomM server
  4. Let R-Shop map systems and pull metadata automatically
  5. Browse, download, and play

For a full walkthrough, see the User Guide.


Philosophy

R-Shop does not host or distribute ROMs.

It is a library management and browsing tool for content users already own or legally access through their own servers, directories, and devices.


Contributing

Contributions are welcome. See CONTRIBUTING.md.

License

MIT