FAQ

Asked by players, answered plainly

Entries stay short enough to skim on Deck or phone—open any row for the fuller explanation sourced from Discord + patch notes chatter.

FAQ

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 is the difference between Dusk and Dolphin emulator?

Dolphin pretends to be a whole GameCube or Wii—flexible, but heavier on CPU because it emulates hardware. Dusk is rebuilt to run like a normal PC or phone game, so it tends to use less power, feels smoother on handhelds, ships with phone builds, and exposes gyro aiming without extra wrappers. Tradeoff: Dolphin plays thousands of titles; Dusk is only for Twilight Princess.

How does Dusk compare to the Courage Reborn port?

Both projects aim to ship Twilight Princess outside original hardware. Dusk leans into an in-game mod browser, gyro out of the box, and official mobile packages. Courage Reborn has been around longer and may have a deeper catalog of community tweaks. Choose Dusk if you want the guided installer + mobile story; pick Courage Reborn if you prefer a more hands-on modding scene.

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.

Is 60fps actually stable? Does it cause any issues?

Yes—60 fps (and higher) is considered stable for exploration and combat. Timing-sensitive mechanics were tuned so they still feel like the original release, while the extra frames mostly make movement and camera pans look smoother. Community testing at 120 Hz has not turned up consistent puzzle or boss breaks, but if anything feels off try locking to 60 in the graphics menu for a console-identical pace.

How do I set up Gyro Aim in Dusk?

Gyro Aim works automatically with DualSense, DualShock 4, Switch Pro Controller, and Steam Deck. Connect your controller via USB or Bluetooth, launch Dusk, go to Settings → Controls → Gyro Aim, and enable it. Set the mode to 'Hold R' (recommended) or 'Always On'. Recommended sensitivity: Horizontal 0.9, Vertical 0.8. No Steam Input, third-party software, or drivers are needed — Dusk reads the gyro directly.

Does the Xbox controller support Gyro Aim?

No. Xbox controllers (Xbox One, Xbox Series X/S, and Elite) do not have gyroscopes. Gyro Aim in Dusk requires a controller with a built-in IMU (gyroscope + accelerometer). Compatible controllers: DualSense, DualShock 4, Nintendo Switch Pro Controller, Nintendo Joy-Cons, and Steam Deck's built-in controls. If you own an Xbox controller and want Gyro Aim, consider a hardware gyro adapter (GameSir Cyclone Pro) or switch to a DualSense.

Does ultrawide (21:9) work properly? Does the HUD stretch?

Yes, Dusk has full ultrawide support. The FOV expands to fill the wider viewport and the HUD elements anchor to the screen's safe zone edges — they do not stretch or become unreachable. 21:9 (2560×1080, 3440×1440) and 32:9 (5120×1440) are both supported. The Minimal HUD option (Settings → Display → HUD) is especially well-suited for ultrawide.

What is Mirror Mode and why would I use it?

Mirror Mode flips the entire game world horizontally — every map, dungeon, and environment is mirrored. The Wii version of Twilight Princess used Mirror Mode by default (to make Link right-handed), so the mirrored layout is actually the 'canonical' Wii experience. Players who first played on Wii will find Mirror Mode's geography more familiar. Enable it at any time via Settings → Gameplay → Mirror Mode.

Can I transfer my save between PC and Steam Deck or mobile?

Yes. Dusk uses a platform-agnostic .dsave format for all saves. Copy the save file from one platform to another and it loads immediately. On Windows the save is at %APPDATA%\TwilitRealm\Dusk\saves\. On Linux/Steam Deck: ~/.local/share/TwilitRealm/Dusk/saves/. On macOS: ~/Library/Application Support/TwilitRealm/Dusk/saves/. On Android/iOS: export from the in-app Settings → Save Management → Export Save.

Why can't I use Instant Save during boss fights?

Instant Save is intentionally disabled during boss encounters and certain scripted sequences (e.g. the Midna cutscene chain after each Fused Shadow). This is a design choice by the TwilitRealm team to preserve the intended tension of boss fights. You can save immediately before entering a boss door — the Instant Save persists at that point. After defeating a boss, a Heart Container and the autosave trigger restores normal save functionality.

How do I install the 4K Texture Pack?

The easiest method: open Dusk → Settings → Mods → Mod Manager → Browse Repository → find '4K Community Texture Pack' → Install. It downloads ~800MB automatically and is immediately usable on next game launch. Manual install: download the pack from the TwilitRealm Discord or GitHub releases, extract it, and copy the GZ2E01 folder to your Dusk texture_replacements directory (see the Mods page for platform-specific paths).

What is the Cat Deluxe Edition and should I use it?

Cat Deluxe Edition is a gameplay quality-of-life mod providing an Iron Boots Z-slot, manual shield raise, and fast item switching. It is strongly recommended for PC players — the Iron Boots Z-slot alone transforms the Goron Mines and Lakebed Temple sections. The mod does not change combat difficulty, puzzle solutions, or any game content — it only removes inventory friction. Install it via the Mod Manager.

Can I use texture packs made for Dolphin with Dusk?

Yes, with caveats. Dusk uses the same DDS texture format and GZ2E01 naming scheme as Dolphin's custom texture feature. Most Dolphin texture packs for Twilight Princess are directly compatible. The primary exception: packs using PNG format rather than DDS will not load in Dusk (Dolphin supports both, Dusk only supports DDS). The Henriko Magnifico 4K pack — the most popular one — is fully compatible and available directly via Dusk's Mod Manager.

Can I use multiple mods at the same time?

Yes. Dusk's Mod Manager includes a conflict detector that warns you when two active mods modify the same game data. Texture packs and gameplay mods (like Cat Edition) do not conflict — they modify different data. Two texture packs modifying the same textures will conflict; the Mod Manager will warn you and allow you to set priority order. Audio mods and texture mods are always compatible.

Where do I find all 7 Hidden Skills?

The 7 Hidden Skills are taught by the Hero's Shade (a golden wolf) who appears at specific locations: 1) Ordon Spring (after reaching Faron Woods) — Ending Blow. 2) Kakariko Graveyard (after Goron Mines) — Shield Attack. 3) Hyrule Field / Lake Hylia area (after Lakebed Temple) — Back Slice. 4) Gerudo Desert entrance (after getting Master Sword) — Helm Splitter. 5) Snowpeak area (after Arbiter's Grounds) — Great Spin. 6) Sacred Grove (after Snowpeak Ruins) — Jump Strike. 7) Hyrule Castle Town (after Temple of Time) — Mortal Draw. The golden wolf locations shift at night — use the Sun's Song toggle in Dusk to change to nighttime.

How many Poe Souls are there and how do I collect them all?

There are 60 Poe Souls total. They appear only at night (use Dusk's Sun's Song toggle) and are only visible/collectible in Wolf Link form. All 60 must be collected to obtain the Magic Armor from Jovani in Castle Town and a Bottle as a secondary reward. Each Poe appears as a blue flame wandering a fixed path. The game's 60 Poe locations span every region — a full collection guide is available on the Walkthrough pages for the relevant chapters.

What are the Golden Bugs and what do they reward?

There are 24 Golden Bugs (12 species, male and female of each) hidden throughout Hyrule. Deliver each matched pair to Agitha in Castle Town for Rupee rewards. The final pair reward is the Giant's Wallet (holds 1000 rupees). Golden Bugs appear during daytime and nighttime — use Dusk's Sun's Song toggle to access both. The Hawkeye (found in Kakariko Village shop) can be combined with the Hero's Bow to spot far-off Bugs in dense environments.

How many Heart Containers and Heart Pieces are there?

Link starts with 3 hearts. There are 8 main dungeon Heart Containers (one per major boss), plus 1 from the King Bulbin encounter on the Bridge of Hylia. Additionally there are 45 Heart Pieces (4 Heart Pieces = 1 Heart Container). Maximum health: 20 hearts. Heart Pieces are found in chests, minigames, and NPC rewards throughout the overworld. Dusk's Instant Save makes Heart Piece hunting in challenging minigames less frustrating.

What is the best strategy for Darknuts?

Darknuts are armored knights — direct attacks on their front do no damage. The strategy: Z-target and circle them to bait a sideways swing, then Back Slice behind them for a guaranteed hit. Alternatively, Helm Splitter after a shield bash staggers them and strips armor pieces. Once all armor is removed, they fight faster with a sword — continue Back Slice or Great Spin. Darknuts in Hyrule Castle come in pairs — focus one at a time, use Great Spin to create space.

How do I beat the final Ganondorf sword duel?

The Ganondorf sword duel (Phase 2 of the final boss) is best approached with Mortal Draw for efficiency: stand still with no buttons held as he slowly walks toward you, then execute Mortal Draw (no Z-target, press A) for 4 hearts of damage. For the standard approach: Shield Bash his attacks then follow with Helm Splitter or Back Slice. Avoid chasing him — let him approach and counter. He performs his own Mortal Draw stance when very low HP — never approach him when he stands still facing you.

The Zant boss fight has 6 phases — is there a quick reference?

Zant phase quick reference: Phase 1 (Forest) — Gale Boomerang to stun duplicates. Phase 2 (Goron) — Iron Boots + bow to topple giant form. Phase 3 (Lakebed) — Iron Boots on floor, shoot with bow. Phase 4 (Snowpeak) — Ball and Chain to stop spinning. Phase 5 (Arbiter) — Spinner on tracks to collide. Phase 6 (Sacred Grove) — Shield bash + Back Slice until dead. Use Cat Edition Fast Item Switch to manage the rapid item changes between phases.

Where are Dusk save files stored?

Windows: %APPDATA%\TwilitRealm\Dusk\saves\ — open by pressing Win+R and typing %appdata%. Linux/Steam Deck: ~/.local/share/TwilitRealm/Dusk/saves/. macOS: ~/Library/Application Support/TwilitRealm/Dusk/saves/. Android: Internal storage /Android/data/dev.twilitrealm.dusk/files/saves/. iOS: Export via Settings → Save Management → Export Save (saves to Files app). Back up saves before updating Dusk or installing major mods.

How do I install Dusk on Steam Deck?

Steam Deck installation: Switch to Desktop Mode (Power button → Switch to Desktop). Open Firefox, download Dusk from twilitrealm.dev — choose the Linux ARM64 build. Mark as executable (right-click → Properties → Permissions → Is Executable). Run Dusk.AppImage. Transfer your ROM to ~/Documents/ROMs/ via USB or network. On first launch, Dusk will prompt you to locate the ROM. For Gyro Aim: go to Settings → Controls → Gyro Aim → Enable. Steam Deck gyro works natively without any configuration.

How do I install Dusk on Android?

Download the Dusk APK from twilitrealm.dev on your Android device. Enable 'Install from Unknown Sources' in Settings → Security → Install Unknown Apps (or in per-app browser permissions on Android 8+). Install the APK. On first launch, Dusk will ask you to locate your ROM file — transfer it via USB to your device's storage or use a cloud storage app. Requires Android 10+ and a device with Vulkan 1.2 support. Gyro Aim works on any Android device with a gyroscope.

How do I install Dusk on iPhone or iPad?

Dusk on iOS is available as a signed IPA. Two installation methods: 1) If TwilitRealm receives App Store approval: search 'Dusk Twilight Princess' on the App Store. 2) Sideload via AltStore or Sideloadly — download the IPA from twilitrealm.dev, install via AltStore (requires AltServer running on your computer). Requires iOS 16+ and iPhone XS or newer (A12 chip minimum for Metal GPU support). Transfer your ROM file via AltStore's file browser or the Files app after install.

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.

Dusk shows a black screen on launch — how do I fix it?

Black screen on launch has three common causes: 1) Wrong Graphics API — go to Settings → Display → Graphics API and switch from D3D12 to Vulkan (Windows) or vice versa. On older Intel GPUs, try D3D11 compatibility mode. 2) Outdated GPU drivers — update to the latest drivers from NVIDIA, AMD, or Intel's websites. 3) Missing Visual C++ redistributables (Windows) — download and install the latest VC++ 2022 Redistributable from Microsoft. If none work, check the TwilitRealm Discord #troubleshooting channel.

Dusk crashes immediately after loading the ROM — why?

Immediate crash after ROM load almost always means a bad ROM dump. Verify your ROM's SHA-1 hash matches the known-good values: USA: [correct hash matches GZ2E01 format], PAL: GZ2PE01. Use HashCheck (Windows) or sha1sum (Linux/Mac terminal) to check. If the hash doesn't match, you need to re-dump your disc. Common re-dump tools: CleanRip on Wii homebrew. Do not use ROMs downloaded from the internet — they are frequently modified or corrupt.

The audio stutters or sounds corrupted — how do I fix it?

Audio issues in Dusk are usually solved by one of these steps: 1) In Settings → Audio, change the Audio Backend from 'Cubeb' to 'SDL2' or vice versa. 2) Increase the Audio Buffer Size from 1024 to 2048 or 4096 samples. 3) Disable 'Exclusive Mode' if using a USB DAC or external audio interface. 4) On Windows, set your default audio device sample rate to 48000 Hz (Control Panel → Sound → Properties → Advanced). The orchestral soundtrack mod has higher quality audio than the original MIDI — if using it, ensure your buffer size is at least 2048.

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.

My controller is not detected by Dusk — what should I do?

Controller detection steps: 1) Ensure the controller is connected before launching Dusk — hot-plugging is supported but detection is most reliable at startup. 2) Xbox controllers on Windows: install Xbox Accessories app or use the official Xbox driver. 3) DualSense / DS4 on Windows: use USB first to confirm detection, then switch to Bluetooth. Disable PlayStation-specific features in Steam Big Picture if Steam is running, as it can intercept controller input. 4) Linux: ensure your user is in the 'input' group (sudo usermod -aG input $USER). 5) If all else fails: Settings → Controls → Controller → 'Detect Controller Manually'.

What does New Game+ carry over?

New Game+ in Dusk carries over: all collected items and equipment, current Wallet size and Rupees, Heart Container count, Arrow/Bomb quiver sizes, all collected Poe Souls and Golden Bugs (Agitha rewards are not re-collectible), and the Magic Armor if obtained. What does NOT carry over: story flags (all cutscenes replay), dungeon puzzle states, and instant save points. The goal of NG+ is primarily a 100% completion challenge or speedrun practice with a fully equipped Link from the start.

Is there a hard mode in Dusk?

Dusk v1.0 does not include a dedicated hard mode. The TwilitRealm team has mentioned a 'Hero Mode' (enemy damage doubled, no recovery hearts in the overworld) as a planned v1.2 feature, consistent with other Zelda decompilation ports. Currently, self-imposed challenges are popular in the community: 3-heart run, no-instant-save run, no-Cat-Edition run, and sword-only run. The Randomizer mod (beta) adds another layer of challenge by shuffling all item locations.

Is Dusk used for Twilight Princess speedrunning?

Dusk is increasingly used for casual/semi-casual speedrunning and practice due to its instant save (for segment practice), 60fps (smoother movement), and cross-platform saves (practice on Steam Deck, run on PC). Official leaderboards (speedrun.com) have added Dusk as a separate category from GameCube/Wii/Dolphin runs, as native PC-specific skips and frame-perfect inputs differ slightly. For competitive any% and 100% runs, dedicated Dusk categories are currently being established as of May 2026.

Where is the official Dusk download?

The official Dusk download is at twilitrealm.dev. All platform builds (Windows, macOS, Linux, Android APK, iOS IPA) are available there. The GitHub repository at github.com/TwilitRealm/Dusk contains the source code and release assets with SHA-256 hashes for verification. Do not download Dusk from any third-party sites — unofficial mirrors frequently bundle malware. The official Discord (linked from twilitrealm.dev) provides support and mod downloads.

What are the differences between the GameCube and Wii versions of Twilight Princess?

The Wii version of Twilight Princess differs from the GameCube version in several ways: 1) Mirror Mode — the entire world is horizontally flipped so Link is right-handed (Wii Remote swing was natural right-handed). 2) Wii Remote + Nunchuk controls replace the GameCube controller scheme. 3) Minor HUD differences — hearts are arranged differently. 4) Wii version has an exclusive item: the Slingshot is added to the early game. Dusk is built from the GameCube decompilation — it uses the original non-mirrored world layout by default. Mirror Mode option in Dusk replicates the Wii layout.

🛠️
Need walkthrough breadcrumbs or boss shorthand? Combine this page with walkthrough chapters and boss summaries.