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 by its official GitHub repository as a reverse-engineered reimplementation of The Legend of Zelda: Twilight Princess. Dusk itself does not include any of the original game’s assets — users must provide their own legally obtained copy of the game.
This guide focuses on getting Dusk running on your platform of choice, confirming compatibility with your existing copy, and surfacing the controller and performance details you’ll need next.
Before you start
Pre-flight checklist
- You own a legally obtained copy of the original GameCube release.
- You can verify the SHA-1 hash of your copy on your computer.
- You have ~1 GB of free disk space for Dusk and any logs.
- You have a supported controller (or keyboard + mouse) ready.
- You can install applications outside of an app store on your platform.
What this guide will not provide
Supported platforms
Dusk targets desktop and mobile environments. Pick your platform and follow the dedicated walkthrough — each one starts with the same SHA-1 verification step before any install action.
Supported versions
At time of writing, Dusk lists the following supported builds. If your copy’s SHA-1 hash matches one of these, you’re good to proceed. Otherwise, see the supported versions page for what unsupported means.
- GameCube USA —
75edd3ddff41f125d1b4ce1a40378f1b565519e7 - GameCube EUR —
2601822a488eeb86fb89db16ca8f29c2c953e1ca
Setup overview
Verify your copy
Compute the SHA-1 hash of your owned copy and compare it to the list above. Continue only when the hash matches.
Install Dusk
Download Dusk from the official project source. Avoid mirrors and bundled “full game” downloads.
Point Dusk at your copy
On first launch, Dusk will ask for the location of your supported copy. Provide it and confirm the version detected.
Configure controls
Set up controller bindings, gyro aim if applicable, and tune performance for your hardware target.
Windows / macOS / Linux overview
On desktop, the install path is similar across operating systems: get the latest Dusk build from the official project, run it, and follow the first-launch prompt. Each desktop platform has its own page with the OS-specific quirks (Gatekeeper on macOS, runtime libraries on Linux, SmartScreen on Windows).
Android overview
Android setup uses an APK install. You will need to allow apps from outside the Play Store, point the app at your supported dump, and connect a controller for the best experience. See the Android guide for the full walkthrough.
iOS reference note
Common mistakes
- Skipping the SHA-1 verification — most “version not recognized” errors trace back to this.
- Using a repacked or modified copy — Dusk expects a clean dump.
- Downloading Dusk from a third-party mirror — always use the official source.
- Using outdated controller drivers — update them before reporting an input bug.
- Running on an unsupported OS version without checking platform requirements first.
Next steps
Once you have Dusk running and recognized your copy, head to your platform’s dedicated guide for performance and controller tuning. If anything fails, the troubleshooting guide covers symptoms, likely causes, and the first safe fix to try.