Dusk hash verification failed
This guide is for the exact moment when Dusk or Dusklight accepts your file selection, starts checking the disc image, and then rejects it with a hash verification message. The fix is not to search for a random replacement file. The fix is to prove whether your own supported GameCube Twilight Princess dump is clean, complete, and one of the versions the official app currently supports.
The supported SHA-1 values
The official Dusklight README publishes two SHA-1 values that users can check outside the app. As of Dusklight v1.2.0, those are still the practical values to use when you are debugging a Dusk hash verification failed message. Type them carefully, compare lowercase to lowercase, and do not ignore one missing character. A single changed byte in the disc image produces a completely different hash.
| Supported version | Game ID | SHA-1 for external verification |
|---|---|---|
| GameCube USA | GZ2E01 | 75edd3ddff41f125d1b4ce1a40378f1b565519e7 |
| GameCube EUR / PAL | GZ2P01 | 2601822a488eeb86fb89db16ca8f29c2c953e1ca |
There are two different hash ideas in play. SHA-1 is the user-friendly value published in the official README. Dusklight itself computes an internal XXH128 value when it validates a selected disc image. The official source code currently maps GZ2E01 to internal value 14e886f08e548a000afde98a3195e788 and GZ2P01 to 9ef597588b0035ca9e91b333fa9a8a7e. You normally do not need to calculate those XXH128 values yourself. For a normal player, the reliable workflow is: verify SHA-1 first, then let Dusklight do its own internal check.
How to verify your dump
Run the command on the file you are actually selecting in Dusk. If you copied the disc image to a handheld, an SD card, a USB drive, or a different folder, hash that copy, not an older backup. Do not hash a zip file that contains the dump. Do not hash a shortcut. Do not hash a folder. The command must point at the disc image file itself.
Windows PowerShell
Open PowerShell in the folder containing your file, then run:
Get-FileHash -Algorithm SHA1 .\twilight-princess.iso
Replace the filename with your actual filename. PowerShell prints a long hexadecimal value. Compare the Hash field with the supported values above.
macOS Terminal
Open Terminal and run:
shasum -a 1 ~/Games/twilight-princess.iso
If your file lives somewhere else, drag it into Terminal after the command to insert the exact path.
Linux and Steam Deck
In Linux desktop mode or Steam Deck Desktop Mode, open a terminal and run:
sha1sum ~/Games/twilight-princess.iso
The Steam Deck is still Linux for this step. If your file is on an SD card, use the real mount path or open a terminal from the file manager location.
Android
Android can calculate hashes with extra tools, but the least confusing route is to verify the dump on a desktop computer before copying it to the phone or handheld. If the desktop SHA-1 matches and the Android copy fails, copy the file again with a reliable cable, card reader, or local network transfer. If the desktop SHA-1 does not match, Android is not the problem.
How to read the result
If the SHA-1 exactly matches the GameCube USA or GameCube EUR value, your base dump is the right supported version. If Dusklight still reports hash verification failed after that, check whether you selected the same file you hashed, whether a compressed conversion changed the data, whether the copy on the target device is incomplete, and whether you are running the official current build. Use the download guide to confirm the app file came from official GitHub releases.
If the SHA-1 does not match either supported value, do not try to force it through troubleshooting. A mismatch usually means you have the wrong region, a Wii disc, a modified ISO, a bad conversion, an incomplete dump, or a file that is not Twilight Princess GameCube USA or PAL. In that situation, the next page is usually the selected game is not supported guide, not a graphics or controller guide.
If your file is intentionally modified, for example a patched ISO or a randomizer-style base image, expect hash verification to complain. A modified disc image is not the same diagnostic case as a clean supported disc image. First prove that clean Dusklight works with a clean supported dump, then test mods or texture replacements through the normal Dusk mod path.
Common causes and what to do
| Cause | What it looks like | Best next step |
|---|---|---|
| Wrong region | The file is Japan, Korea, Wii, or another edition. | Read supported versions and unsupported game errors. |
| Incomplete dump | The copy finished too quickly, has a suspicious size, or came from a split transfer. | Re-dump or re-copy, then run SHA-1 again before launching Dusk. |
| Modified image | The file was patched, randomized, rebuilt, trimmed, or changed by another tool. | Test with a clean dump first. Keep modded images out of baseline troubleshooting. |
| Converted format | A compressed or converted file fails while the original may work. | Use a clean ISO or GCM as the control file while debugging. |
| Unofficial app build | The download came from a mirror or repack. | Install the official Dusklight build from GitHub and retest. |
Safe troubleshooting order
- Install the latest official Dusklight release from the project GitHub.
- Verify the SHA-1 of your own disc image on a desktop computer.
- Confirm the value is exactly one of the two supported GameCube values.
- Copy the verified file to the target device only after it passes.
- Launch Dusklight with no mods and no texture pack changes.
- If it works, add texture packs, controller profiles, and other changes one at a time.
Hash verification FAQ
Is this a Dusk download problem?
Sometimes, but not usually. If the Dusk program came from the official release page, hash verification failure is normally about the selected game data, not the app download. If you downloaded the app from somewhere else, remove that variable and use the official build first.
Can I fix the hash by renaming the file?
No. The filename does not decide the hash. The hash is calculated from the actual bytes inside the disc image. Renaming a Japan, Wii, corrupted, or modified file to look like a USA ISO will not make it supported.
Does this site provide a working ROM, ISO, or RVZ?
No. This site does not host or link to ROMs, ISOs, RVZ files, dumps, torrents, mirrors, or copyrighted game data. It explains how to download the official Dusklight app and how to troubleshoot your own supported disc image.
What if my hash matches but Dusk still rejects it?
Check that you selected the same file you hashed, that the target-device copy completed correctly, and that the app is the latest official Dusklight release. If a clean supported image still fails in a clean official build, collect the app version, platform, exact error text, and steps, then check official GitHub Issues.
Related pages
Use disc image safety for the legal boundary, unsupported game errors for region and version issues, Dusk not working for general symptom triage, and Dusk Twilight Princess download for official app files.