1Retro
Getting Started
Set up 1Retro on your devices in just a few minutes.
Enable network access on your MiSTer
Make sure your MiSTer is connected to your local network via Ethernet or Wi-Fi. SSH should be enabled (it is by default on most MiSTer setups).
Install the sync tool
SSH into your MiSTer and pull the latest binary and daemon script straight from the API:
cd /media/fat/Scripts
wget https://api.1retro.com/v1/downloads/latest/1retro-mister/1retro-mister
wget https://api.1retro.com/v1/downloads/latest/1retro-mister/1retro-mister-daemon.sh
chmod +x 1retro-mister 1retro-mister-daemon.shThe /downloads/latest/... endpoint always 302-redirects to the most recent published build, so re-running these commands later upgrades both files in place.
Sign in once
SSH into your MiSTer and run the login command. It opens a device authorization flow — scan the QR code (or open the URL) on your phone to link the MiSTer to your 1Retro account:
/media/fat/Scripts/1retro-mister loginIf the device is already linked, login returns immediately, so this command is safe to call from scripts.
Run a sync
To run a one-shot sync from the shell:
/media/fat/Scripts/1retro-mister syncFor continuous syncing in the foreground (useful while testing):
/media/fat/Scripts/1retro-mister watchRun as a background service (optional)
The bundled daemon script wraps watch with start/stop/status/restart:
/media/fat/Scripts/1retro-mister-daemon.sh start
/media/fat/Scripts/1retro-mister-daemon.sh status
/media/fat/Scripts/1retro-mister-daemon.sh stopLogs land in /media/fat/1retro/daemon.log.
To start automatically at boot, append this line to /media/fat/linux/user-startup.sh:
/media/fat/Scripts/1retro-mister-daemon.sh startGood to know
- MiSTer saves are stored in /media/fat/saves/ (or /media/fat/games/ depending on your setup).
- 1Retro maps each MiSTer core to the correct system automatically.
- You can sync once, watch continuously in the foreground, or run as a background service.