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
Download the CLI
Grab the 1retro CLI binary for your platform from the Download page. It works on macOS, Windows, and Linux.
Authenticate
Run the login command to authenticate with your 1Retro account, or use an app password for headless environments.
Configure your save directories
Tell the CLI where your saves are stored. You can point it at one or more directories, and it will detect the system and format automatically.
Sync
Run a one-time sync or set up a watch mode. The CLI supports push, pull, and bidirectional sync. Integrate it into scripts, cron jobs, or custom workflows.
Good to know
- The CLI is ideal for headless servers, custom setups, or automation.
- Supports all the same systems and formats as the desktop app.
Ready to download?
Get the cli tools for your platform.