A desktop app for managing retro game ROM libraries. Search games via IGDB, discover ROMs through extensible addon sources, and organize your collection by platform and device.
- IGDB Integration - Search and browse games with full metadata, cover art, and platform info
- Addon System - Extensible plugin architecture for ROM and BIOS sources
- Import Manager - Queued imports with progress tracking, pause/resume, and concurrent transfers
- Device Profiles - Pre-configured profiles for popular handhelds (Miyoo Mini, Anbernic, Steam Deck, etc.)
- Library Management - Organize ROMs by platform with automatic file placement
- BIOS Management - Organize BIOS files and install firmware files for each platform
Download the latest release for your platform from the Releases page, or visit the Get Started guide for per-platform download cards and setup instructions.
brew tap tvcsantos/retrosync
brew install --cask retrosync
git clone https://github.com/tvcsantos/retrosync.git
cd retrosync
npm install
npm run devnpm run build:mac # macOS DMG
npm run build:win # Windows installer
npm run build:linux # Linux packages (AppImage, deb)- Architecture - Tech stack, design decisions, data flow
- Addon Development - Build external addons for RetroSync
- Contributing - Development setup, code style, project structure
Electron | React 19 | TypeScript | Vite | SQLite (Drizzle ORM) | Tailwind CSS 4 | Zustand
See LICENSE for details.