Back
ra-offline
by cheasan
|
| Version | 0.4.5 |
| Zip size | 290 KiB |
| License | MIT |
| Updated | 24/10/2026 |
| Downloads | 103 |
| MD5 | e3fdb89baa526829351bab5a4884b078 |
App Details
ra-offline is an Atmosphere sysmodule that acts as an offline loopback server for RetroAchievements.
While you play RetroArch without an internet connection, it pretends to be retroachievements.org on the Switch itself: game data is served from a local cache and every achievement you unlock is queued on the SD card. As soon as the Switch comes back online, the queued unlocks are replayed to the real retroachievements.org over TLS - automatically, and nothing is lost if the connection drops.
## Setup (required after install)
1. Save your account: run the fetch-cache.py tool from the GitHub repo once on a computer (needs your RetroAchievements account), then copy the resulting folder to sd:/switch/raoffline
2. Point RetroArch at the proxy: set cheevos_custom_host = \"http://127.0.0.1:8080\" in retroarch/retroarch.cfg (the ra-config.sh helper from the repo does this for you), then restart RetroArch
3. Reboot the console so the sysmodule starts
4. Cache your games before you go offline. We recommend that you start each game once while the Switch is online: the module caches it, and you see that achievements load. To cache every game on the SD card in one run, start the ra-offline cacher app from the Homebrew Menu and press A.
Offline, only cached games have achievements. A game that was never cached shows \"Not cached offline. Play this game once online to cache it.\"
## Notes
- Requires Atmosphere CFW and the standard RetroArch Switch build
- The module logs to sd:/switch/raoffline/sysmodule.log for troubleshooting
- Uninstall: delete sd:/atmosphere/contents/4300000000000042 and remove the cheevos_custom_host line from retroarch.cfg
## Links
- Source and documentation: https://github.com/cheasan/switch-retro-offline
- Not affiliated with RetroAchievements.org, the RetroArch team, or Nintendo.
Changelog
v0.4.5
- Games cache themselves: start a game while the Switch is online, and the module saves its achievement data for offline play.
- New ra-offline cacher app (switch/ra-offline-cacher): press A to cache every game on the SD card in one run. No restart needed.
- Offline, an uncached game now says what to do: \"Not cached offline. Play this game once online to cache it.\"
v0.4.4
- Games you add to the cache now work at once. No reboot needed: the module re-reads cache/hashes.txt when it meets an unknown game.
- Verified with a Sphaira forwarder launch.
v0.4.3
- First full run on Switch hardware: offline unlocks and leaderboard times now sync from the console to retroachievements.org.
- Fix: sync never connected (TLS service not started, socket handed over the wrong way).
- Fix: an unlock already on the server no longer retries forever.
- Fix: replies match current RetroArch (no 'Awarded achievement 0' or leaderboard submit errors).
- The log now names the failing step or quotes the server's error.
v0.1.1
- Install fix: package now ships atmosphere/contents/4300000000000042/flags/boot2.flag, which Atmosphere requires to start the sysmodule at boot (without it the module silently never launched).
v0.1.0
- First public release