DuskPort

How to Install Dusk on Steam Deck (Twilight Princess Guide)

Install Dusk Twilight Princess PC port on Steam Deck. Verified setup flow, real settings paths, native gyro aim, and the only published Deck performance datapoint.

Published 2026-05-10

The Steam Deck runs Dusk via the Linux x86_64 build. Setup is straightforward and uses the same “add as non-Steam game” pattern that works for other Linux applications on the Deck.

This guide is verified against the Dusk source code, the official FAQ, and Steam Deck HQ’s review (the only published Deck benchmark to date).

Time required: ~10–15 minutes Difficulty: Easy

What You’ll Need

  1. A Steam Deck (LCD or OLED — both run the same Linux x86_64 build)
  2. Your own legal GameCube TP disc dump in any supported format (ISO, GCM, CISO, GCZ, NFS, RVZ, WBFS, WIA, TGC). If you don’t have one yet, see How to dump your TP disc legally.
  3. A few minutes in Desktop Mode

Step 1 — Switch to Desktop Mode

  1. Press STEAM
  2. Select Power
  3. Select Switch to Desktop

The Deck reboots into KDE Plasma. Use the right trackpad as a mouse, the right trigger as left-click, and STEAM + X for an on-screen keyboard.

Step 2 — Download the Linux Build

  1. Open Firefox
  2. Go to github.com/TwilitRealm/dusk/releases
  3. Under v1.0.0 Assets, download Dusk-v1.0.0-linux-x86_64.zip (~30 MB)

Verified SHA-256: da9edeef6e0c4233e7f461a854aa1f41119f68848b4e00e037149be8298e13ca

Step 3 — Extract and Make Executable

  1. Open the Dolphin file manager (the desktop app — confusingly shares a name with the GameCube emulator, but it’s KDE’s file browser).

  2. Navigate to ~/Downloads

  3. Right-click Dusk-v1.0.0-linux-x86_64.zip → Extract Archive Here

  4. Move the extracted Dusk folder somewhere stable. Reasonable choices:

    • ~/Applications/Dusk/
    • ~/Games/Dusk/

  5. Open Konsole (terminal) from the start menu under “System”.

  6. Mark the binary executable:

    cd ~/Applications/Dusk
chmod +x Dusk

  7. Drop your GameCube disc dump into a folder you’ll remember:

    mkdir -p ~/Games/TwilightPrincess

    Then drag-and-drop your disc image there using the file manager.

Step 4 — Add to Steam as a Non-Steam Game

  1. Open the Steam desktop client (shortcut on the desktop)
  2. Games → Add a Non-Steam Game to My Library…
  3. Browse… and pick ~/Applications/Dusk/Dusk (the executable, not the folder)
  4. Click Add Selected Programs

Optional polish:

  • Right-click the entry → Properties → rename to “Dusk: Twilight Princess” for clarity
  • Add cover art from SteamGridDB — Dusk artwork is already uploaded

Step 5 — Return to Game Mode

  1. Double-click Return to Gaming Mode on the desktop
  2. The Deck reboots into the standard Steam UI
  3. Find Dusk in your library
  4. Press A to launch

The first launch shows the Dusk prelaunch menu. Highlight Select Disc Image, press A, and pick your disc dump from the Files dialog. Dusk verifies the hash, shows “Disc ready.”, and the button changes to Play.

Step 6 — Configure Controls and Gyro Aim

The Deck’s default GameCube-style layout works without configuration. To customize, the verified paths are:

Settings → Input → Gyro → Gyro Aim → toggle on

Then Gyro Input Method → Sensor (this reads the Deck’s IMU directly)

Adjust Gyro Pitch Sensitivity, Gyro Yaw Sensitivity, and Gyro Deadband to taste.

Or use mouse aim instead

Settings → Input → Gyro → Gyro Input Method → Mouse

This routes input through a virtual mouse, which Steam Input can drive from the Deck’s gyro if you want to use Steam’s gyro-to-mouse feature instead.

Trackpad-as-mouse alternative

If you prefer the right trackpad as your aiming surface, leave Gyro Aim off and use the Deck’s standard Steam Input mouse mapping.

⚠️ Use only one gyro method at a time. Native sensor + Steam Input gyro-to-mouse will fight each other.

Common Steam Deck-relevant settings

SettingPath
Toggle fullscreenSettings → Video → Display → Toggle Fullscreen
Show FPS counterSettings → Video → Display → Show FPS Counter
Unlock framerateSettings → Video → Rendering → Unlock Framerate
Internal resolutionSettings → Video → Resolution → Internal Resolution
4:3 aspect lockSettings → Video → Display → Lock 4:3 Aspect Ratio

Performance: What’s Actually Known

The only published Deck benchmark we could verify (as of 2026-05-10):

“Even when pushing it to 90 FPS, it will still stick below 11W battery drain.” — Steam Deck HQ

That’s the entire dataset. No hours-of-battery numbers, no settings disclosed, no scene tested. We’ll update this section as more verified benchmarks appear.

What we can reasonably extrapolate (but cannot verify):

  • The GameCube ran TP at 30 FPS targeting 485 MHz hardware. Modern Deck silicon is dramatically faster.
  • Project’s stated framerate target: “up to 120 FPS” (Time Extension pre-release coverage). This is a design goal, not a measured ceiling on the Deck.
  • Battery life will depend heavily on framerate cap, TDP setting, and refresh rate. Test what works for you and adjust.

Save Files on Steam Deck

Per the official FAQ (twilitrealm.dev/faq):

  • Linux save path: ~/.local/share/TwilitRealm/Dusk/USA/Card A/
  • Replace USA with EUR if you’re using the PAL disc
  • Save filename: 01-GZ2*-gczelda2.gci

If you’ve been playing TP in Dolphin on PC and want to bring your save:

  1. Find your Dolphin GCI on PC: Documents/Dolphin Emulator/GC/USA/Card A/01-GZ2E01-gczelda2.gci
  2. Copy it to your Deck (USB / cloud / SCP)
  3. Drop it into ~/.local/share/TwilitRealm/Dusk/USA/Card A/
  4. Restart Dusk; the save appears in the load menu

Common Issues

”Permission denied” when launching from Steam

You skipped the chmod +x Dusk step. Re-run it from Konsole.

Steam doesn’t show the executable in the file picker

Steam’s “Add Non-Steam Game” can hide files without an extension. In the file picker, set the dropdown to All Files.

Audio crackles

Try toggling the audio backend (PulseAudio ↔ PipeWire) at the Deck system level.

Game runs but the controller does nothing

Steam Input may have hijacked the controller for desktop mode. Open the in-game overlay → Controller Settings → Templates → pick Gamepad, not Desktop.

My ROM dump is rejected

Verify SHA-1 in Konsole:

sha1sum ~/Games/TwilightPrincess/your-dump.iso

Should match 75edd3ddff41f125d1b4ce1a40378f1b565519e7 (NTSC-U) or 2601822a488eeb86fb89db16ca8f29c2c953e1ca (PAL). If not, re-dump.

App tries to write to root filesystem

There is a known v1.0.0 Linux AppImage bug (#818) that may show:

[fatal] [dusk] Unable to get PrefPath: Couldn't create directory '/TwilitRealm': 'Permission denied'

The fix is to use the regular .zip build (which this guide does), not the AppImage variant.

Final Setup Checklist

  • ✅ Dusk launches from Game Mode
  • ✅ Title screen shows; audio plays
  • ✅ Disc verified; status reads Disc ready.
  • ✅ Gyro aim configured (native or mouse mode)
  • ✅ Save tested (save in Ordon Village, restart, verify load)

Useful Add-ons

Last updated: 2026-05-10. We update this guide as Deck-specific patches and benchmarks are published.

← All install guides · Pillar guide →