Install Dusk on your device
Choose a platform below for a focused walkthrough. Every guide assumes you already own the GameCube release and will handle your own disc dump—this wiki never links to pirated copies.
Before you download anything
Dusk bundles only the Twilight Princess-compatible engine wrapper. Provide a valid North American or PAL
GameCube image (GZ2E01 USA / GZ2PE01 PAL) ripped with something like CleanRip—mirrors from random ROM sites frequently fail hashes and can carry malware.
Dusk also pairs well with archival workflows: screenshot your Dolphin per-game profile if you intend to reuse controller bindings mentally, then treat Dusk as a fresh launcher rather than blindly copying GFX hacks—native ports expose different sliders and sane defaults rarely line up one-to-one.
Launcher basics
- Grab official builds only from TwilitRealm’s site / GitHub release page.
- Allow the launcher through SmartScreen/GateKeeper the first launch.
- Back up saves before beta mods or reinstalls (.dsave files).
Quick hardware check
- Modern GPU APIs (Vulkan 1.2, D3D12, or Metal) keep cutscenes smooth.
- Budget rigs still run nicely at native res with optional QoL mods.
- Use wired controllers for first-time pairing if Bluetooth acts flaky.
Pick your platform
Windows
PopularWindows 10/11 64-bit · Direct3D 12 or Vulkan · most common path
macOS
NativeApple Silicon & Intel macOS installs with Metal acceleration
Linux
LinuxAppImage · Vulkan · works great on desktops + Deck-like PCs
Steam Deck
HandheldDesktop Mode download · gyro-ready · Verified-style instructions
Android
SideloadAPK sideload · Vulkan-ready phones & tablets · pick ROM from storage
iOS
AltStoreAltStore IPA path · newer Apple GPUs only · ROM via Files app
Video walkthroughs
Prefer seeing the flow? These third-party videos stay embedded with YouTube’s privacy-enhanced player.
Windows install overview
Covers download, extraction, ROM placement, and first boot settings.
Feature tour + 4K pack
High-level look at visual upgrades and mod manager usage.
Setup questions
Is Dusk legal to download and use?
Downloading the free Dusk app from its official creators is generally fine—the launcher itself does not bundle Nintendo music, textures, maps, or a Twilight Princess ROM. Think of Dusk like a specialized player that still needs your own disc backup. You must provide a dump you made from a GameCube disc you purchased; downloading random ISOs online is usually illegal and risky (malware-filled images are common).
What ROM do I need and where do I get it?
Dusk requires the GameCube version of Twilight Princess (North America or PAL). The USA version SHA-1 hash is GZ2E01, PAL is GZ2PE01. You must dump your own ROM from a physical disc you legally own using a softmodded Wii or GameCube with a compatible loader. The most common method uses the CleanRip homebrew app on a Wii. Do not download ROMs from the internet — this is illegal and often distributes malware-infected files.
What platforms does Dusk support?
Dusk v1.0 supports Windows (x86-64), macOS (Apple Silicon ARM64 and Intel x86-64), Linux (x86-64), Steam Deck (official Verified status), Android (ARM64, requires Vulkan), and iOS (ARM64, requires A12 chip or newer — iPhone XS or later). All platforms share the same .dsave cross-platform save format.
What are the minimum PC specifications for Dusk?
Minimum: Windows 10 64-bit or macOS 12 Monterey or Linux (kernel 5.4+); CPU with AVX2 support (Intel Haswell 2013+ or AMD Ryzen 1000+); 4GB RAM; GPU supporting DirectX 12, Vulkan 1.2, or Metal 2 (Intel HD 530+, AMD RX 470+, NVIDIA GTX 950+, or Apple M1). Recommended for 4K: 8GB RAM, dedicated GPU with 4GB VRAM, Ryzen 5 3600 or Intel i5-10600.
How do I update Dusk to a new version?
Dusk checks for updates automatically at launch and shows a notification if a new version is available. Click 'Update' to download and install — the process takes 1–3 minutes. Your saves, ROM location, settings, and installed mods are preserved across updates. If the auto-update fails, download the new installer manually from twilitrealm.dev and run it over the existing installation. Always back up your saves before major version updates.
Windows shows a SmartScreen warning when running Dusk — is it safe?
Yes, Dusk is safe. The SmartScreen warning appears because Dusk.exe is not signed with a paid Microsoft code-signing certificate — an expensive ($400+/year) requirement that community projects typically skip. To bypass: click 'More info' on the SmartScreen popup, then click 'Run anyway'. Alternatively, right-click Dusk.exe → Properties → check 'Unblock' at the bottom. You can verify the file integrity yourself using the SHA-256 hash published on the official TwilitRealm GitHub releases page.
macOS says Dusk is damaged and can't be opened — how do I fix it?
This is macOS Gatekeeper blocking an unsigned application. Fix: open Terminal and run: xattr -cr /Applications/Dusk.app (adjust path if you placed it elsewhere). Then launch Dusk normally. Alternatively: right-click Dusk.app → Open → Open (in the dialog). This adds a Gatekeeper exception for Dusk specifically. You only need to do this once. This is a standard procedure for any open-source application distributed outside the Mac App Store.