How to Install Dusklight (Dusk) Twilight Princess — All Platforms

Dusklight (previously known as Dusk) is a native PC port of The Legend of Zelda: Twilight Princess. It was developed by the TwilitRealm team based on a full game decompilation and was released in May 2026. It runs very smoothly, supports higher frame rates, works with multiple controllers, allows texture mods, and the best part is that it can run easily on many devices without using an emulator.

This guide has been updated for the latest stable release v1.3.0. Always download from the official GitHub source or dusklightguide.com only.

Before You Start

You need a legal GameCube disc dump. Dusklight does not include any Nintendo files inside it. To play the game, you will need to use your own legally dumped copy of the GameCube version of Twilight Princess.

Download only from the official source. Go to: github.com/TwilitRealm/dusklight/releases or dusklightguide.com/install

Update to version v1.3.0. This update fixes many problems, such as crashes on Apple Silicon Macs, the Ilia hair bug, Windows file path issues, and save file visibility problems.

Supported Versions

Region	Game ID	SHA-1 Hash	Status
GameCube USA	GZ2E01	75edd3ddff41f125d1b4ce1a40378f1b565519e7	✅ Supported
GameCube PAL (Europe/Australia)	GZ2P01	2601822a488eeb86fb89db16ca8f29c2c953e1ca	✅ Supported
GameCube Japan	GZ2J01	—	Coming soon
Wii versions	Various	—	Coming soon

Supported file formats: ISO, GCM, CISO, GCZ, NFS, RVZ, WBFS, WIA, TGC.

After Installation: Where Your Files Are Stored

Easiest way: Start Dusklight → Go to Settings → Interface → Open Data Folder. This button takes you straight to the right folder on any device.

Save File Locations

Platform	Current Save Folder (v1.0.1)	Future Folder (Dusklight rebrand)
Windows	%APPDATA%\TwilitRealm\Dusk\USA\Card A\	%APPDATA%\TwilitRealm\Dusklight\USA\Card A\
macOS	~/Library/Application Support/TwilitRealm/Dusk/USA/Card A/	~/Library/Application Support/TwilitRealm/Dusklight/USA/Card A/
Linux / Steam Deck	~/.local/share/TwilitRealm/Dusk/USA/Card A/	~/.local/share/TwilitRealm/Dusklight/USA/Card A/
Android	/sdcard/Android/data/dev.twilitrealm.dusk/files/USA/Card A/	TBD
iOS	On My iPhone → Dusk → USA → Card A (in Files app)	TBD

• If you have the European version, use EUR instead of USA.
• Save file name: 01-GZ2*-gczelda2.gci
• If you use Dolphin Emulator, simply copy your .gci save files into the correct folder.

Texture Packs: Put the GZ2* folder inside the texture_replacements/ folder (or Texture_Replacement/ on Android).

Pick Your Platform

Quick Troubleshooting

For detailed platform-wise solutions for Windows, Steam Deck, Android, macOS, and iOS, visit the complete guide: Dusklight Known Issues & Fixes Guide

• Hash check failed → Dump your disc again and verify the SHA-1 hash check.
• Game not supported → Only use USA or PAL GameCube versions.
• Stuck at 30 FPS → Go to Video settings and enable “Unlock Framerate.”
• Controller or gyro problems → Go to Settings → Input and check the controls.
• Texture packs are not working → Properly check the folder name and use version v1.3.0 or newer.

Next Steps for a Better Experience

Install Henriko Magnifico’s 4K Texture Pack (the size is around 6 GB).

Also try different graphics settings — Vulkan or D3D12 usually give you much better performance.

You can also enable cool built-in features like free camera, Mirror Mode (Wii style), achievements, and a speedrun timer.

Your old Dolphin save files can also be transferred easily.

At the current time, Dusklight is considered one of the best ways to play Twilight Princess. It offers modern performance, mod support, and support for multiple devices. With every new update, the project keeps getting even better.

Enjoy your adventure in Hyrule!