Install Dusk / Dusklight Twilight Princess — All Platforms

Install Dusk (a.k.a. Dusklight) — the Twilight Princess native PC port — on Windows, macOS, Linux, Steam Deck, Android, or iOS. v1.4.1 downloads.

Published 2026-05-10 ·Updated 2026-06-20

Dusklight ships native binaries for five platform families. The Steam Deck runs the Linux build. Pick yours below — each guide walks you through download, ROM verification, first launch, and known issues for that platform. Current latest: v1.4.1, released 2026-06-16.

📦 All downloads come from one place: github.com/TwilitRealm/dusklight/releases. Don’t trust mirrors or third-party “free download” sites.

Before you start: things that apply to every platform

1. You need your own GameCube Twilight Princess disc dump

Dusklight does not ship Nintendo assets. You must legally dump your own retail GameCube disc. If you don’t have a dump:

→ How to legally dump your Twilight Princess disc

2. Only GameCube NA + PAL are supported

Region	Game ID	Status
GameCube USA	GZ2E01	✅ Supported
GameCube PAL (Europe / Australia)	GZ2P01	✅ Supported
GameCube Japan	GZ2J01	⏳ Recognized, planned
Wii (any region)	various	⏳ Recognized, planned
Wii U Twilight Princess HD	various	❌ Not supported (different game)

3. Supported disc formats

ISO, GCM, CISO, GCZ, NFS, RVZ, WBFS, WIA, TGC. Compressed formats (RVZ, CISO) save disk space.

Pick your platform (v1.4.1)

🪟 Windows

x86_64 (most PCs): Dusklight-v1.4.1-win32-x86_64.zip (35.9 MB)
ARM64 (Surface Pro X / Windows on ARM): Dusklight-v1.4.1-win32-arm64.zip (33.0 MB) — native ARM build now ships
Portable .zip (no installer). v1.4.0 bundles the VC++ redistributable DLLs.
→ Step-by-step Windows install guide

🍎 macOS

Apple Silicon (M-series): Dusklight-v1.4.1-macos-arm64.zip (27.3 MB)
Intel Mac: Dusklight-v1.4.1-macos-x86_64.zip (29.0 MB)
✅ v1.4.0 restores macOS 12 support
⏳ Separate shader-cache crash #826 still open
→ Step-by-step macOS install guide

🐧 Linux (desktop)

x86_64 (most PCs): Dusklight-v1.4.1-linux-x86_64.AppImage (32.0 MB)
ARM64: Dusklight-v1.4.1-linux-arm64.AppImage (30.7 MB) — arm64 AppImage now ships every release
AppImage-only (no .zip). May need libfuse2 on some distros.
→ Step-by-step Linux install guide

🎮 Steam Deck

Use the Linux x86_64 AppImage (same file as desktop Linux): Dusklight-v1.4.1-linux-x86_64.AppImage. Setup is via Desktop Mode → “Add as non-Steam Game”.

→ Step-by-step Steam Deck install guide

Steam Deck users — frequently asked: the file you want is Dusklight-v1.4.1-linux-x86_64.AppImage (Steam Deck has an x86_64 AMD chip — grab the x86_64 AppImage, not the arm64 one).

🤖 Android

File: Dusklight-v1.4.1-android-arm64.apk (56.9 MB)
Method: Sideload only (not on Play Store)
✅ v1.4.0 adds first-class mobile touch controls plus native gyro/rumble — a gamepad is now optional
→ Step-by-step Android install guide

📱 iOS

File: Dusklight-v1.4.1-ios-arm64.ipa (25.9 MB)
Method: AltStore sideload (free Apple ID = 7-day cert; paid dev = 1 year)
Requires: iOS 16+ with Developer Mode enabled
✅ v1.4.0 adds mobile touch controls plus native gyro/rumble on iOS
→ Step-by-step iOS install guide

ARM vs x86 — which one do I pick?

This is the most asked question across community threads. Quick reference:

Device	Build to download
Most PCs / laptops (Intel or AMD)	x86_64
Steam Deck (LCD or OLED)	x86_64
Apple Silicon Mac (M1, M2, M3, M4)	macOS arm64
Intel Mac	macOS x86_64
Raspberry Pi 5 / ARM single-board computer	Linux arm64
Most Android phones	android-arm64 (only build offered)
iPhone / iPad	ios-arm64 (only build offered)
Surface Pro X / Windows on ARM	Windows arm64 (native build now ships)

After install: where things live

Easiest: inside Dusklight, go to Settings → Interface → Open Data Folder — jumps straight to the right location regardless of OS.

For manual reference, the official FAQ lists these paths. Since the Dusklight rebrand the desktop folder is Dusklight (the app auto-migrates old saves from the legacy Dusk folder on first launch):

Platform	Save folder
Windows	`%APPDATA%\TwilitRealm\Dusklight\USA\Card A\`
macOS	`~/Library/Application Support/TwilitRealm/Dusklight/USA/Card A/`
Linux	`~/.local/share/TwilitRealm/Dusklight/USA/Card A/`
Android	`/sdcard/Android/data/dev.twilitrealm.dusk/files/USA/Card A/`
iOS	On My iPhone → Dusklight → USA → Card A (Files app)

Replace USA with EUR if you’re using the European disc. The save filename is 01-GZ2*-gczelda2.gci.

Texture pack install paths (verified against v1.4.1 source code)

The Dusklight source defines texture_replacements/ as a hardcoded subfolder of the per-platform data directory (src/dusk/data.cpp). v1.4.0 also added ASTC DDS support (mobile packs) and the ability to load mipmaps from within DDS files.

Platform	Texture pack folder
Windows	`%APPDATA%\TwilitRealm\Dusklight\texture_replacements\`
Linux	`~/.local/share/TwilitRealm/Dusklight/texture_replacements/`
macOS	`~/Library/Application Support/TwilitRealm/Dusklight/texture_replacements/`
Android	`/sdcard/Android/data/dev.twilitrealm.dusk/files/Texture_Replacement/`

Drop the GZ2* folder from the texture pack zip into the path above, or use Settings → Interface → Open Data Folder to navigate directly.

The most popular texture pack is Henriko Magnifico’s 4K Twilight Princess pack — ~6 GB for 4K, ~3 GB for 1080p.

Cross-cutting troubleshooting

These apply on any platform:

“Disc image did not pass hash verification” → hash verification fix
“The selected game is not supported” → region & version guide
Stuck at 30 FPS → unlock checklist
Moving a save from Dolphin → Dolphin save migration
Moving a save between devices → cross-device sync
Full hub → all known issues

What’s next

Last updated: 2026-06-20. We update this hub when new platform builds ship.