Skip to content
Dusk Guide

macOS

Twilight Princess Dusk on macOS

Two builds: pick by CPU. Then it's the same four steps as every other desktop platform — extract, launch, point at your dump, play. The macOS-specific bit is handling Gatekeeper on first run.

UPDATED 2026-05-115 minBeginner

No ROMs / no copyrighted assets

This independent guide does not host or link to game files. Use your own legally obtained copy.

What you need first

  • macOS up to date (Apple's currently supported releases).
  • A legally obtained dump of Twilight Princess (GameCube USA / PAL).
  • Your dump's SHA-1 hash matches a build on /supported-versions.
  • Terminal access (just for one xattr command if Gatekeeper blocks the binary).

Which build (arm64 vs x86_64)

To check your CPU: Apple menu → About This Mac.

  • Apple Silicon (M1, M2, M3, M4 …): Dusk-v1.0.0-macos-arm64.zip — 28.0 MB — download.
  • Intel: Dusk-v1.0.0-macos-x86_64.zip — 29.6 MB — download.

Verified against the GitHub Releases API on 2026-05-11.

Install steps

  1. Extract the .zip. Double-click in Finder. Move the resulting Dusk.app to /Applications if you like.
  2. Launch Dusk. First-launch may show a Gatekeeper warning — see next section.
  3. Press “Select Disc Image” and provide the path to your supported dump.
  4. Press “Play”.

Gatekeeper / quarantine

Apps downloaded from the web get a com.apple.quarantine attribute. Unsigned releases of small projects often get blocked on first run. Two ways to allow it:

Option A — System Settings (most users)

  1. Try to open Dusk normally; macOS will block it with “Apple cannot check it for malicious software” or similar.
  2. Open System Settings → Privacy & Security.
  3. Scroll down. Next to the Dusk message, click Open Anyway.
  4. Click Open on the next confirmation dialog.

Option B — Terminal one-liner (if the GUI option doesn’t appear)

Some macOS versions hide the “Open Anyway” button if the app comes from an unidentified source. Drop the quarantine attribute manually:

xattr -dr com.apple.quarantine /Applications/Dusk.app

Adjust the path if you put Dusk somewhere other than /Applications. The flag -dr means “delete recursively”.

If you’re stuck

Related guides