-
Notifications
You must be signed in to change notification settings - Fork 15
Getting Started
- Go to the Releases page and download the latest
.dmg. - Open the DMG and drag OpenEmu.app to your Applications folder.
- Launch OpenEmu. The app is notarized by Apple — no Gatekeeper workaround or
xattrcommand is needed.
Requirements: macOS 11.0 (Big Sur) or later, Apple Silicon Mac (M1/M2/M3/M4). Intel Macs are not supported.
The first time you open OpenEmu, a Setup Assistant walks you through core installation. The cores are the emulation engines for each system.
Leave the core selection as-is unless you know exactly what you're doing. Installing all available cores is the right choice for most users.
Click Go when the assistant finishes — you'll land in your game library.
OpenEmu accesses controllers and keyboards at the hardware level (via IOKit HID), which requires a special macOS permission.
If your keyboard or controller isn't responding in-game:
- Open System Settings → Privacy & Security → Input Monitoring
- Add OpenEmu to the list (use the
+button or drag the app in)
Even though macOS labels this "keyboard monitoring," it applies to all input devices including gamepads. OpenEmu cannot read your passwords — macOS blocks that automatically.
Drag and drop a ROM file onto the OpenEmu library window. That's it.
- For standard cartridge-based games (NES, SNES, GBA, etc.): just drop the file.
- For CD-based games (PlayStation, Sega CD, Saturn, etc.): follow the CD-Based Games guide — these require extra steps.
- For systems that need BIOS files (PlayStation, Sega CD, Saturn, Dreamcast, etc.): see the BIOS Files guide before trying to play.
OpenEmu-Silicon integrates with ScreenScraper for automatic box art. Go to OpenEmu → Preferences → Cover Art, enter your screenscraper.fr credentials (free account), and your library will fill in automatically.
- BIOS Files — check if any system you want to use requires a BIOS
- Importing Games — file types, import errors, and tips
- Controllers — supported controllers and pairing guides
- Troubleshooting: Reporting Problems — if something isn't working