Skip to main content
1Retro

Getting Started

Set up 1Retro on your devices in just a few minutes.

Desktop App
macOS, Windows, Linux
Android App
Phones, tablets, handhelds
MiSTer FPGA
DE10-Nano
OnionOS
Miyoo Mini, TrimUI, and others
CLI Tools
Terminal and scripting

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 the helper scripts 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-sync.sh
wget https://api.1retro.com/v1/downloads/latest/1retro-mister/1retro-mister-daemon.sh
chmod +x 1retro-mister 1retro-mister-sync.sh 1retro-mister-daemon.sh

Dropping the .sh scripts in /media/fat/Scripts makes them show up in the MiSTer Scripts menu. The /downloads/latest/... endpoint always 302-redirects to the most recent published build, so re-running these commands later upgrades the 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 login

If the device is already linked, login returns immediately, so this command is safe to call from scripts.

Run a sync

Pick 1retro-mister-sync from the MiSTer Scripts menu to sync once and drop back to the menu — no SSH needed. The first run walks you through login on screen.

To do the same from the shell:

/media/fat/Scripts/1retro-mister-sync.sh

Or call the binary directly for a one-shot sync:

/media/fat/Scripts/1retro-mister sync

For continuous syncing in the foreground (useful while testing):

/media/fat/Scripts/1retro-mister watch

Run 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 stop

Logs 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 start

Good 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.
Ready to download?
Get the mister fpga for your platform.
Download

Ready to sync your saves?

Free to start. No credit card required.

Create Free Account