Install · Game data & first launch
Game data & first launch
Use this after Install. Dusk targets The Legend of Zelda: Twilight Princess on Nintendo GameCube: you supply a legal disc image whose SHA-1 matches a supported retail build below. We do not host dumps or link to ROM sites.
For legal and technical context on disc images you own (no redistribution, verify hashes), see Disc dumps & mirrors. The engine project lists steps as verify → download → in-app setup; here, download is covered from the home page and Install guides. You may verify your dump before or after fetching Dusk, but the hash must match before you rely on Play.
Graphics hardware
Dusk needs a GPU with D3D12, Vulkan, or Metal support. Results vary by driver and device: older Intel integrated graphics are prone to issues, and some Adreno GPUs have known quirks. If the app opens but rendering fails, check FAQ and upstream notes on twilitrealm.dev.
Install the app, then this page (by platform)
Getting Dusk onto your device depends on the OS. After it launches, everyone follows sections 2 · Launch and 3 · Select disc image below — the same in-app flow the project documents for desktop and Android.
- Windows, macOS, Linux: extract or run the build from Install (pick your OS), then return here for hash check and disc attachment.
- Android: install the apk (Install → Android), launch Dusk, then use Select Disc Image and Play like desktop — file pickers and permissions differ, not the core steps.
- iOS: installation is different — you must finish Install → iOS first (the project documents a AltStore-based path on that page). Only when Dusk opens normally should you use sections 2–3 here to pick your verified dump.
GameCube disc images (.iso, .gcm) and this project
Guides and search phrases often mention a "Twilight Princess GameCube ISO." For Dusk, that really means "a supported retail GameCube rip of Twilight Princess." Common container extensions include .iso, .gcm, or files produced by ripping tools — the decisive check is matching one of the official hashes below, not the filename suffix.
If your hash differs, assume the rip is unsupported (wrong revision, patching, truncation, bad dump) until release notes cover it. Problems after a match? Try the FAQ.
1 · Verify your dump
Compare the SHA-1 of your image to a supported build below. If it does not match, Dusk may refuse the file or behave incorrectly. Other retail builds may be added over time — watch release notes.
| Version | SHA-1 |
|---|---|
| GameCube USA | 75edd3ddff41f125d1b4ce1a40378f1b565519e7 |
| GameCube EUR | 2601822a488eeb86fb89db16ca8f29c2c953e1ca |
Goal: a clean, byte-identical image of a disc you own. Examples with built-in tools:
- Windows (PowerShell):
Get-FileHash -Algorithm SHA1 .\path\to\dump.iso - macOS:
shasum -a 1 /path/to/dump.iso - Linux:
sha1sum /path/to/dump.iso
2 · Launch Dusk
Open the app from your install location (Install). You should land in Dusk's launcher: pick a disc image, optionally adjust settings the build exposes, and start once the file is accepted.
3 · Select disc image
- Choose Select Disc Image (or the equivalent entry in the menu).
- Point Dusk at your verified GameCube dump file on disk or on-device storage (Android/iOS paths differ).
- Press Play once the image is accepted.
Android follows the same post-install flow as desktop once the apk is installed. iOS users must complete Install → iOS before these steps apply; paths and the Files app differ, but the launcher actions are the same.
Common questions
- Does this site provide Twilight Princess files or ISO links?
- No — only how to install Dusk and how to verify your own GameCube rip.
- Can I use any Zelda Twilight Princess GameCube dump?
- Only if its SHA-1 matches a supported retail entry in the table. Other regions or edited images are not covered here unless noted in upstream release docs.
- ISO vs GCM — which do I need?
- Extensions are shorthand; correctness is checksum + clean rip. Re-verify after any conversion or patching.
- What GPU or graphics API does Dusk need?
- A GPU with D3D12, Vulkan, or Metal. Older Intel integrated graphics and some Adreno GPUs are more likely to misbehave.
- What do disc product codes like GZ2E01 mean?
- Retail GameCube identifiers for supported Twilight Princess builds:
GZ2E01is the USA image andGZ2P01is the European image — same entries as the SHA-1 table above, just another way labels appear on dumps or guides. - Is Wii supported?
- These steps target supported GameCube builds. Wii or other SKU support is announced with the engine — check twilitrealm.dev and the FAQ.
- Where do I report bugs?
- Use GitHub Issues for the engine; use contact only for this website.