Dusk 'Disc Image Did Not Pass Hash Verification' — Fix
Dusk rejects your TP ISO with a hash-verification error. The two known-good SHA-1 hashes, how to verify your dump on every OS, and what to do if neither matches.
This is Dusklight telling you the ROM you pointed it at doesn’t match its internal whitelist of known-good Twilight Princess dumps.
The two accepted SHA-1 hashes (v1.0.x)
| Region | Game ID | SHA-1 |
|---|---|---|
| GameCube NTSC-U (USA) | GZ2E01 | 75edd3ddff41f125d1b4ce1a40378f1b565519e7 |
| GameCube PAL (EU/AU) | GZ2P01 | 2601822a488eeb86fb89db16ca8f29c2c953e1ca |
Source: src/dusk/iso_validate.cpp on the Dusklight repo. Player’s Choice and Best Of reissues share the same SHA-1 as the original.
Verify your dump
Windows (PowerShell)
Get-FileHash -Algorithm SHA1 .\twilight-princess.iso
macOS (Terminal)
shasum -a 1 ~/Games/twilight-princess.iso
Linux (Terminal)
sha1sum ~/Games/twilight-princess.iso
The output should match exactly (no spaces, no 0x) one of the two hashes above.
What “no match” usually means
| Cause | What to do |
|---|---|
| Corrupted dump (FAT32 split file not reassembled) | Re-concatenate part0/part1 — see the legal dump guide |
| Wrong region (Japan / Wii / Wii Korea) | v1.0.x supports only NTSC-U + PAL. Other regions are planned per the project README |
| Wii U HD ISO | Wii U TP HD isn’t a GameCube disc image and Dusklight doesn’t play it. Use Cemu for HD |
| Scene release | ”Scene” or NKit-converted dumps may differ. Re-dump from your own disc |
| Compressed format | Dusklight accepts ISO/GCM/CISO/GCZ/NFS/RVZ/WBFS/WIA/TGC, but each computes a different XXH128. If verification fails on a compressed dump, decompress to ISO first to rule out the converter |
Loading a modded ISO intentionally
If you’re using the Linkle character mod or another ISO patch, the hash will not match — that’s expected. Dusklight shows a warning but offers a “Continue anyway” option:
“Just install the mod as you usually would directly to the GameCube or Wii .iso and then direct Dusklight to that modded .iso file and confirm that you still want to use it when it tells you it’s probably corrupted or modified.” — TomoAries, r/pcgaming (14 upvotes)
Related
- Legal dump guide — the canonical CleanRip workflow
- Unsupported game error — different message for wrong region
- Mods & texture packs
- All known issues
Last updated 2026-05-14.