No ROMs / no copyrighted assets
This independent guide does not host or link to game files. Use your own legally obtained copy.
What you need first
- A current Linux distribution.
- A GPU with Vulkan support — Mesa for AMD/Intel iGPU, or proprietary NVIDIA driver.
- A legally obtained dump of Twilight Princess (GameCube USA or PAL/EUR).
- Your dump's SHA-1 matches a build on /supported-versions.
- Terminal access — for chmod and to read stderr if something fails.
Which build
- x86_64 (most desktops / laptops):
Dusk-v1.0.0-linux-x86_64.zip— 30.7 MB — download. - arm64 (Raspberry Pi, ARM laptops, ARM cloud VMs):
Dusk-v1.0.0-linux-arm64.zip— 29.8 MB — download.
Confirm with uname -m if you’re unsure.
Install steps
- Extract the .zip.
unzip Dusk-v1.0.0-linux-x86_64.zip -d ~/dusk(or your file manager). - Mark the binary executable if needed:
chmod +x ~/dusk/Dusk. - Run from a terminal first so you see any missing-library errors:
cd ~/dusk && ./Dusk. - Press “Select Disc Image”, point at your dump, then Play.
Vulkan / GPU stack
The README requires D3D12, Vulkan, or Metal — on Linux that means Vulkan. If ./Dusk exits with a Vulkan loader or layer error:
- Debian / Ubuntu:
sudo apt install libvulkan1 vulkan-tools mesa-vulkan-drivers. Confirm withvulkaninfo --summary. - Fedora:
sudo dnf install vulkan-loader vulkan-tools mesa-vulkan-drivers. - Arch / Manjaro:
sudo pacman -S vulkan-icd-loader vulkan-toolsplus the ICD package for your GPU (vulkan-radeon,vulkan-intel, ornvidia-utils). - NVIDIA proprietary: Vulkan ships with the driver; no extra package, but make sure the driver is installed.
If you’re stuck
- Won’t launch at all → run from terminal first; capture stderr; see won’t launch for the diagnostic tree.
- “Disc image not recognized” → disc image not recognized.
- “Unsupported version” → unsupported version.
- Anything else — official Discord discord.gg/dusktp.