Track play sessions on Android with retroshelf
Install the retroshelf Android app to automatically track every game you play on Retroid, AYN, Ayaneo, and other Android handhelds, and sync it to your collection.
What you need
Set up retroshelf
Install the retroshelf app, link it to your account, and start playing. The whole setup takes a few minutes.
Install the app
Install it one of two ways. Pick whichever you prefer.
Add to Obtainium. Obtainium installs the app from our GitHub releases and keeps it updated automatically. The best option if you want hands-off updates.
Or manually add to Obtainium
- 1Open Obtainium and tap Add App.
- 2Paste this into App source URL:
https://github.com/retroshelf-org/android - 3Tap Add — Obtainium installs from our GitHub releases and keeps it updated.
Download the APK. Grab the latest release and install it yourself. You'll need to repeat this when a new version ships.
Follow the on-screen setup
Open retroshelf and follow the setup it walks you through: granting the permissions it needs and linking your account. When prompted, go to retroshelf.org/link on your phone or computer and enter the code shown in the app.
Play games
That's it. Start playing and retroshelf tracks your sessions automatically, then syncs them to your collection. How it tracks depends on your launcher, explained below.
How tracking works
retroshelf tracks your play time in one of two ways, depending on how you launch your games. Both run automatically once the app is set up.
ES-DE launcher
If ES-DE is your launcher, you're done. retroshelf reads your ES-DE play history and syncs every session in the background. Nothing to configure, nothing to tap.
Emulator tracking
Using a different launcher, or no launcher at all? Turn on Emulator tracking and retroshelf detects every emulator session for you. The only thing you do is confirm which game you were playing when the app asks.
Either way, sessions you record offline are saved on the device and synced the next time you're online, so nothing is lost. And when you install through Obtainium, the app keeps itself up to date with each new release.
Troubleshooting
Sessions aren't being recorded
Usage access is the usual cause. Open Android Settings › Usage access, find retroshelf, and confirm it's enabled. Android sometimes revokes this permission after an update.
The Obtainium button does nothing on desktop
That's expected. The link opens the Obtainium app, which only exists on Android. Open this page on your handheld or phone, or download the APK directly instead.
Ready to start?
Set up in under 5 minutes
Install the app and link your Android device to start tracking.
FAQ
Which Android devices does the retroshelf tracker work on?
Any device running Android 10 or later. That covers Android retro handhelds like the Retroid Pocket, AYN Odin, and Ayaneo Pocket, as well as regular Android phones and tablets.
Does the retroshelf app need root?
No. The tracker uses the standard Android usage-access permission to see which emulator is in the foreground. No root, no custom ROM.
What is Obtainium and why would I use it?
Obtainium is a free, open-source app installer that pulls updates straight from a GitHub project's releases. Add retroshelf once and Obtainium keeps it up to date automatically, with no store account and no manual re-downloads.
Does the app track play time in the background?
Yes. Once you grant usage access, retroshelf records a session whenever you play in a supported emulator and syncs it the next time you are online. You do not need to keep the app open.
How do I unlink or remove the app?
To unlink, open Settings on retroshelf and revoke the device. To remove the app, uninstall it from Android like any other app.
Related