Installation

🚀 Installation

OpenROM comes as a ZIP for every platform — no installer, no dependencies, no drama.

---

🪟 Windows

1. Download OpenROM_Windows_Portable.zip from the latest release
2. Unzip it anywhere you like
3. Double-click OpenROM.exe

SmartScreen warning? Click "More info" → "Run anyway" — this is normal for unsigned indie apps.

---

🐧 Linux

1. Download OpenROM_Linux_x86_64.zip from the latest release
2. Unzip it
3. Make the binary executable and run:

cd OpenROM_Linux_x86_64/
chmod +x OpenROM
./OpenROM

Or add it to your PATH for system-wide access:

sudo cp OpenROM /usr/local/bin/
sudo cp openrom-core /usr/local/bin/

---

🍎 macOS

Apple Silicon (M1/M2/M3/M4)

Download OpenROM_macOS_arm64.zip

Intel Mac

Download OpenROM_macOS_x86_64.zip

Then:

1. Unzip the file
2. Move OpenROM.app to your Applications folder
3. Right-click → Open → Open (first launch only)

Gatekeeper warning? Run this in Terminal:

xattr -cr /Applications/OpenROM.app

Then try opening again.

---

🤖 Android (Termux)

Android support via Termux is available now. See Termux Guide for full setup.

---

🎮 Steam Deck

Use the Linux build. See Steam Deck Guide for the full setup.

---

🤓 Running from Source

Requirements:

• Python 3.10+
• Flutter 3.27+
• pip

git clone https://github.com/M5Devs/OpenROM
cd OpenROM

# Build headless Python core
pip install -r requirements.txt
python -m nuitka --onefile --output-filename=openrom-core core/cli.py

# Run Flutter UI
cd openrom_flutter
flutter pub get
flutter run -d windows   # or linux / macos

Build release packages:

# Windows
build_windows.bat

# Linux
./build_linux.sh

# macOS
./build_mac.sh

Output lands in dist/release/.

---

Something not working?

→ Troubleshooting