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.

Published 2026-05-14 ·Updated 2026-05-14

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)

RegionGame IDSHA-1
GameCube NTSC-U (USA)GZ2E0175edd3ddff41f125d1b4ce1a40378f1b565519e7
GameCube PAL (EU/AU)GZ2P012601822a488eeb86fb89db16ca8f29c2c953e1ca

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

CauseWhat 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 ISOWii 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 formatDusklight 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)

Last updated 2026-05-14.