RetroCompat

SETUP CHECKER

// dependency verification for all platforms //
Detecting platform...
V2.0
REQUIREMENTS MET 0 / 0
Windows path: WinUAE is used as the emulation engine. The wrapper generates a .uae config at launch time and runs WinUAE silently. Packages include VBS + BAT launchers. Optional EXE bundling via PyInstaller.
REQUIRED
✓
Python 3.7+
Runs the wrapper tool itself. Must be added to PATH during install — tick "Add Python to PATH" on the installer screen.
required3.7 – 3.13
CHECK in Command Prompt / PowerShell
>python --version
>python -c "import tkinter; print('tkinter OK')"
↗ Download ↗ Guide
✓
WinUAE 5.x
The Amiga emulator. Download the installer or portable zip. Point the wrapper at whichever folder contains winuae64.exe.
required64-bit recommended
CHECK – does the exe exist?
>dir "C:\Program Files\WinUAE\winuae64.exe"
↗ Download ↗ winuae.net
✓
Kickstart ROM
The Amiga BIOS. Not distributable — must be sourced legally. Amiga Forever is the simplest legal source. One ROM per machine type.
requiredlegal source only
COMMON ROM FILENAMES
#kick34005.A500 — A500 OCS KS1.3
#kick40068.A1200 — A1200 AGA KS3.1
#kick40060.CD32 — CD32 KS3.1
↗ Amiga Forever ↗ amigaroms.com
OPTIONAL
✓
PyInstaller
Enables EXE output mode — bundles the game, emulator and config into a single double-click .exe file. Not needed for folder package output.
optionalenables EXE mode
INSTALL
>pip install pyinstaller
CHECK
>pyinstaller --version
↗ pyinstaller.org
▶QUICK INSTALL — copy & paste this whole block
PowerShell — install everything in one go
>winget install Python.Python.3.12 # installs Python 3.12
>pip install pyinstaller # optional EXE mode
Note: WinUAE and Kickstart ROMs must be downloaded manually — they cannot be installed via package manager.
macOS path: FS-UAE is used as the emulation engine. The wrapper generates an .fs-uae config and a .command launcher. Optional .app bundle via PyInstaller. Homebrew is the easiest path for dependencies.
REQUIRED
✓
Python 3.7+ with tkinter
macOS ships Python 2 only. Install Python 3 from python.org or Homebrew. The python.org installer includes tkinter.
requiredincludes tkinter
CHECK
$python3 --version
$python3 -c "import tkinter; print('tkinter OK')"
INSTALL
$brew install python-tk # Homebrew (recommended)
↗ python.org ↗ Homebrew
✓
FS-UAE
Amiga emulator for macOS. Install the .dmg app or via Homebrew. The wrapper looks for it at /Applications/FS-UAE.app or in your PATH.
required2.9+ or 3.x
CHECK
$ls /Applications/FS-UAE.app
INSTALL
$brew install --cask fs-uae
↗ fs-uae.net ↗ Homebrew cask
✓
Kickstart ROM
Must be legally sourced. Amiga Forever provides ROMs in a format FS-UAE accepts directly. FS-UAE also has its own ROM scanner.
requiredlegal source only
FS-UAE ROM SCAN
$fs-uae-rom-scanner # scans ~/Documents/FS-UAE/ROMs
↗ Amiga Forever
✓
Gatekeeper — allow .command files
macOS blocks unsigned scripts by default. First time opening the .command file: right-click → Open → Open. After that it runs normally.
one-time setup
OR — remove quarantine flag
$xattr -d com.apple.quarantine Run_Wrapper.command
↗ Apple guide
OPTIONAL
✓
PyInstaller
Enables .app bundle output.
optionalenables .app mode
$pip3 install pyinstaller
↗ pyinstaller.org
✓
Homebrew
Makes installing Python, FS-UAE, and PyInstaller much simpler. Recommended first step on a fresh Mac.
optionalsimplifies setup
$/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
↗ brew.sh
▶QUICK INSTALL — Homebrew one-liner
$brew install python-tk && brew install --cask fs-uae && pip3 install pyinstaller
ChromeOS note: The wrapper runs inside the Linux container (Crostini). Enable it once in Settings, then everything works like a standard Linux install.
STEP 0 — ENABLE LINUX CONTAINER
✓
Linux (Crostini) — enable once
Settings → Advanced → Developers → Linux development environment → Turn On. Takes a few minutes, one-time only.
one-time setupChromebook 2019+
VERIFY in Linux terminal
$cat /etc/debian_version # should show 11 or 12
↗ Google guide
REQUIRED — run in Linux Terminal
✓
Python 3 + tkinter
Python 3 is usually pre-installed in Crostini. tkinter needs to be installed separately as python3-tk.
required
INSTALL
$sudo apt update && sudo apt install -y python3 python3-tk
↗ pkg info
✓
FS-UAE
Available directly from Debian repos via apt. Installs cleanly in Crostini.
required
$sudo apt install -y fs-uae && fs-uae --version
↗ fs-uae.net
✓
Kickstart ROM
Copy your ROM via the Files app — drag it to the Linux Files section. ~/Downloads is shared between ChromeOS and Linux.
requiredlegal source only
$ls ~/Downloads/ # shared with ChromeOS Files
↗ Amiga Forever
▶FULL SETUP — paste into Linux Terminal
$sudo apt update && sudo apt install -y python3 python3-tk fs-uae
$pip3 install pyinstaller # optional EXE/bundle mode
Linux path: FS-UAE from system packages. Python 3 + tkinter from apt/dnf/pacman. The wrapper generates .fs-uae configs and .sh launchers. Same path as ChromeOS Crostini.
REQUIRED
✓
Python 3 + tkinter
Python 3 is usually present. The tkinter binding is a separate package on most distros.
required
CHECK
$python3 --version && python3 -c "import tkinter"
INSTALL BY DISTRO
$sudo apt install python3 python3-tk # Debian / Ubuntu / Mint
$sudo dnf install python3 python3-tkinter # Fedora / RHEL
$sudo pacman -S python tk # Arch / Manjaro
↗ python.org
✓
FS-UAE
Available in most distro repos.
required
INSTALL BY DISTRO
$sudo apt install fs-uae # Debian / Ubuntu
$sudo dnf install fs-uae # Fedora
$sudo pacman -S fs-uae # Arch
CHECK
$which fs-uae && fs-uae --version
↗ fs-uae.net
✓
Kickstart ROM
Same legal requirement as all platforms. FS-UAE on Linux has a ROM scanner built in.
requiredlegal source only
$fs-uae-rom-scanner
↗ Amiga Forever
OPTIONAL
✓
PyInstaller
Enables single-binary output mode.
optional
$pip3 install pyinstaller
↗ pyinstaller.org
PLATFORM COMPARISON
⊞ WINDOWS
⌘ macOS
⬡ CHROMEOS / ❖ LINUX
Emulator
WinUAE
FS-UAE
FS-UAE
Config format
.uae
.fs-uae
.fs-uae
Launcher
VBS + BAT
.command
.sh
EXE / App bundle
.exe
.app
binary
Setup difficulty
Easy
Medium (Gatekeeper)
Medium (enable Linux)
Library JSON
shared
shared
shared
Browser-based heuristic scan. Detects your OS via User-Agent and checks what it can from JavaScript. ChromeOS detection is definitive. For a complete shell-level check of every binary, use the downloadable scripts on each platform tab.
RETROCOMPAT :: DEPENDENCY SCANNER
// Select platform above, then press START SCAN
RESULT 0FOUND 0UNVERIFIABLE 0ISSUES
Note: Items marked UNVERIFIABLE cannot be checked from a browser — they require running a shell command. Use the check commands in the CHECKER tab, or download the platform check scripts linked there.

Reference links for all RetroCompat Amiga Wrapper dependencies, tools, and community resources.

🕹AMIGA EMULATORS
WinUAE
Windows onlyfree
The most accurate Amiga emulator. v5.x supports all models, CD32, CDTV. Used by RetroCompat on Windows.
FS-UAE
cross-platformfree
WinUAE core, runs on macOS, Linux, Windows. Used by RetroCompat on macOS/Linux/ChromeOS.
FS-UAE Launcher
cross-platformfree
GUI frontend for FS-UAE. RetroCompat bypasses this with its own generated .fs-uae config.
RetroArch + PUAE core
cross-platformfree
Alternative path. Good for casual use, less precise config control than WinUAE/FS-UAE.
💾KICKSTART ROMS
Amiga Forever — Cloanto
Official, fully legal source for all Kickstart ROMs. Value edition includes all ROMs in FS-UAE compatible format. Simplest legal route.
amigaroms.com
Alternative legal ROM source. Individual and bundle purchases available.
FS-UAE ROM documentation
Which ROM filenames FS-UAE expects, SHA1 hashes for verification, and how the ROM scanner works.
🐍PYTHON & TOOLS
Python — python.org
cross-platformfree
Official installer. Always tick "Add Python to PATH" on Windows. Includes tkinter on all platforms.
PyInstaller
cross-platformfree
Bundles Python apps into standalone executables. Required for EXE / .app bundle output mode.
Homebrew
free
Package manager for macOS. Easiest way to install Python with tkinter and FS-UAE in one command.
winget
Windowsfree
Windows Package Manager. Built into Windows 11. Easiest way to install Python on Windows.
📦AMIGA GAME SOURCES
Lemon Amiga
Comprehensive Amiga game database — reviews, box scans, disk counts, hardware requirements.
Hall of Light (HOL)
Detailed database of every commercial Amiga release including hardware requirements and screenshots.
Amiga Forever free files
free legal downloads
Free-to-download Amiga games and demos in RP9 format. Directly importable into RetroCompat via RP9 import button.
Amiga Magazine Rack (AMR)
Ultimate Amiga magazine resource — full scans of Amiga Power, CU Amiga, Amiga Format and dozens more, all searchable.
📁FILE FORMATS
ADF — Amiga Disk File
Standard floppy image format (.adf). 880KB per disk. Most common format for game distribution.
RP9 — Amiga Forever Package
Zip archive containing disk images + XML metadata. RetroCompat imports these directly via the RP9 import function.
WHDLoad
System that installs floppy games to hard disk for better compatibility, faster loading and memory handling.
FS-UAE config format (.fs-uae)
INI-style config file format used by FS-UAE. RetroCompat generates these automatically per-game.
🌐COMMUNITY
English Amiga Board (EAB)
Largest active Amiga community. Support, WHDLoad patches, hardware, software and emulation discussion.
r/amiga
Active subreddit. Good for setup help, game recommendations and general Amiga chat.
AmigaWorld.net
News, forums and community for both classic and modern Amiga platforms.
Enable Linux on ChromeOS
Official Google guide for enabling the Crostini Linux container on a Chromebook.