Skip to content
Dusk Guide

Setup

How to set up Twilight Princess Dusk

The official README boils setup down to four steps: verify your dump, download Dusk, point Dusk at the dump, play. This page gives you the right link for each platform plus the gotchas that trip people up.

UPDATED 2026-05-116 minBeginner

Independent guide

Independent fan-made guide. Not affiliated with Nintendo, The Legend of Zelda, Twilight Princess, Twilit Realm, or Dusk. We do not host, link to, sell, mirror, or distribute ROMs, ISOs, disc images, game files, copyrighted assets, keys, cracks, or bypass tools. Use your own legally obtained copy.

What is Dusk?

Dusk is described in its official GitHub README as “a reverse-engineered reimplementation of Twilight Princess.” In practice it’s the runtime — the executable plus the platform glue — and it expects you to provide your own legally obtained dump of the original game.

Before you start

  • A legally obtained dump of Twilight Princess (GameCube USA = GZ2E01, or PAL = GZ2PE01).
  • Your dump's SHA-1 hash matches a build on /supported-versions.
  • A platform Dusk supports: Windows, macOS (arm64 or x86_64), Linux (x86_64 or arm64), Steam Deck, Android (arm64), iOS.
  • A GPU with D3D12, Vulkan, or Metal support (per the README).
  • Roughly 30–50 MB free for the Dusk build, plus space for your dump.

What we won’t provide

The four official steps

Straight from the README. Same four steps on every desktop platform; Android adds a sideload step; iOS replaces step 2 with the AltStore flow.

I

Verify your dump

Compute SHA-1 on your file (how), compare to supported versions. Continue only when the hash matches.

II

Download Dusk

Pick the right file by platform and CPU. Full table on /download. Direct from github.com/TwilitRealm/dusk.

III

Select Disc Image

Launch Dusk. On the welcome screen, press Select Disc Image and provide the path to your verified dump.

IV

Play

Press Play. If it doesn’t work, run from a terminal so you can see the first error — see won’t launch.

By platform

Each link below is the verified walkthrough for that platform.

  • Windows — extract zip, allow SmartScreen.
  • macOS — pick arm64 / x86_64, handle Gatekeeper (System Settings or xattr command).
  • Linux — pick x86_64 / arm64, install Vulkan loader for your distro.
  • Steam Deck — use the Linux x86_64 build via Desktop Mode, then add as a non-Steam game.
  • Android — sideload the official APK, allow install source, grant storage permission.
  • iOS — Mac required: Homebrew + AltServer + AltStore + Apple ID. Full guide.

GPU requirement note

Common mistakes

  • Skipping SHA-1 verification — most “disc image not recognized” reports trace back to this.
  • Using a repacked / trimmed / modified dump — Dusk expects a clean file.
  • Downloading from a third-party mirror or repacker — only use the official GitHub release.
  • Picking the wrong CPU build (e.g. macOS Intel build on an Apple Silicon Mac).
  • Falling for “preconfigured” or “full game” downloads in search results.

If something fails

Three guides cover the symptoms we have real diagnostic data for:

Anything else, the official Discord at discord.gg/dusktp is the fastest path to a human.

Quick reference for Twilight Princess Dusk setup

To recap the Twilight Princess Dusk setup flow in one paragraph: confirm your GameCube dump matches a supported SHA-1 (USA GZ2E01 or PAL GZ2PE01), download the official v1.0.0 build for your platform from GitHub, extract or sideload it, launch Dusk, click Select Disc Image, and press Play. The four steps are the same on Windows, macOS, Linux, Steam Deck, and Android; iOS adds the AltStore signing flow.

For the per-platform Twilight Princess Dusk install guide, pick: Windows, macOS, Linux, Steam Deck, Android, or iOS. Each page lists the exact file name, the OS-specific permission gotcha, and links back here.

Latest tracked release: v1.0.0 · published 2026-05-09 · last verified 2026-05-11. Listed builds: GameCube USA · GameCube EUR.

Related guides