Install · macOS

Install on macOS

Builds are distributed as a .dmg on CI nightlies and many emulator tags. Use only files from GitHub Assets.

Open CI releases → Continuous Build (macOS…), or emulator releases.
Under Assets, download the .dmg for macOS.
Open the disk image and drag Citron into Applications, or run it from the mounted volume.
If macOS blocks launch: System Settings → Privacy & Security or right-click → Open the first time.
First launch: keys, firmware, and game directories — first-time setup. Extra detail: emulator readme.

Prefer a tagged build?

Emulator releases — same install flow when a .dmg is published.