Dusklight auf Linux installieren — Twilight Princess PC-Port

Dusklight auf Linux installieren (x86_64 + ARM64). AppImage-Berechtigungsbug vermeiden, Spielstand-Pfade finden und das richtige Grafik-Backend für deine Distro wählen.

Veröffentlicht 2026-05-10 ·Aktualisiert 2026-06-20

Diese Anleitung erklärt die Installation von Dusklight (ehemals Dusk) — dem nativen Twilight-Princess-PC-Port — auf dem Linux-Desktop. Für den Steam Deck gibt es eine eigene Steam-Deck-Anleitung (der Deck nutzt denselben Linux-x86_64-Binary, aber der Setup-Ablauf unterscheidet sich).

Zeitaufwand: ~10 Minuten Schwierigkeit: Einfach

⚠️ Wichtige Änderung — nur noch AppImage unter Linux

Dusklight liefert für Linux ausschließlich .AppImage-Builds. Beide Architekturen werden bei jedem Release veröffentlicht: x86_64 und ein natives ARM64-AppImage. Die .zip-Varianten älterer Releases werden nicht mehr genutzt.

Der AppImage-Berechtigungsbug (#818), der früher fatale Startfehler wie diesen verursacht hat:

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

…scheint mit dem Wechsel zu AppImage als offiziellem Linux-Distributionsformat behoben worden zu sein. Falls du diesen Fehler trotzdem noch unter v1.4.1 siehst, bitte ein neues Issue eröffnen.

Wenn du früher eine alte AppImage-Version genutzt und dabei ein verwaistes /TwilitRealm-Verzeichnis im Root hinterlassen hast, räume es auf: sudo rm -rf /TwilitRealm (nur ausführen, wenn du sicher bist, dass der Pfad von dir stammt).

Bevor du anfängst

1. Architektur bestimmen

Im Terminal ausführen:

uname -m

x86_64 → die meisten Desktops, Laptops und Steam Deck → x86_64-Build verwenden
aarch64 / arm64 → Raspberry Pi 5, ARM-Laptops → arm64-Build verwenden

2. Vulkan-Unterstützung (empfohlen)

Dusklight unterstützt 7 Grafik-Backends, aber Vulkan und OpenGL sind die typischen Linux-Standards. Vulkan-Verfügbarkeit prüfen:

Ubuntu / Debian:

sudo apt install vulkan-tools mesa-vulkan-drivers
vulkaninfo --summary

Arch:

sudo pacman -S vulkan-tools vulkan-icd-loader

Fedora:

sudo dnf install vulkan-tools mesa-vulkan-drivers

Falls Vulkan nicht funktioniert, kann man in Settings → Prelaunch → Graphics Backend auf OpenGL oder OpenGL ES wechseln.

3. Dein eigener GameCube-Twilight-Princess-Disc-Dump

Pflicht. Siehe So liest du deine TP-Disc legal aus.

Unterstützte Discs:

GameCube USA (GZ2E01) — SHA-1 75edd3ddff41f125d1b4ce1a40378f1b565519e7
GameCube PAL (GZ2P01) — SHA-1 2601822a488eeb86fb89db16ca8f29c2c953e1ca

Schritt 1 — Dusklight herunterladen

Das AppImage von github.com/TwilitRealm/dusklight/releases herunterladen:

Architektur	Datei	Größe	Hinweise
x86_64	`Dusklight-v1.4.1-linux-x86_64.AppImage`	32,0 MB	Aktuelle v1.4.1 — nur AppImage
ARM64	`Dusklight-v1.4.1-linux-arm64.AppImage`	30,7 MB	Natives ARM64-AppImage, erscheint bei jedem Release

Download verifizieren:

sha256sum ~/Downloads/Dusklight-v1.4.1-linux-x86_64.AppImage

Die Ausgabe mit dem auf der GitHub-Releases-Seite veröffentlichten Wert für diesen Asset vergleichen.

Schritt 2 — Ausführbar machen

cd ~/Downloads
chmod +x Dusklight-v1.4.1-linux-x86_64.AppImage
mkdir -p ~/Applications && mv Dusklight-v1.4.1-linux-x86_64.AppImage ~/Applications/

Auf manchen Distros wird für AppImages außerdem libfuse2 benötigt:

Ubuntu/Debian: sudo apt install libfuse2
Arch: sudo pacman -S fuse2
Fedora: in der Regel bereits installiert

Schritt 3 — ROM verifizieren

sha1sum ~/path/to/your-dump.iso

Der SHA-1 muss 75edd3ddff41f125d1b4ce1a40378f1b565519e7 (NTSC-U) oder 2601822a488eeb86fb89db16ca8f29c2c953e1ca (PAL) ergeben.

Schritt 4 — Erster Start

~/Applications/Dusklight-v1.4.1-linux-x86_64.AppImage

Das Dusklight-Prelaunch-Fenster öffnet sich. Select Disc Image klicken, zum Disc-Dump navigieren und auf „Verifying disc image” warten. Sobald der Status „Disc ready.” zeigt, auf Play klicken.

Schritt 5 — Controller / Gyro einrichten

Verifizierter Pfad:

Settings → Input → Controller → Configure Controller

Ein Port-Fenster öffnet sich mit den Reitern Port 1, Port 2, … und den Seiten Controller / Buttons / Triggers / Sticks / Rumble.

Gyro-Aim aktivieren:

Settings → Input → Gyro → Gyro Aim (einschalten)

Linux unterstützt DualShock 4/5, Switch Pro Controller (mit hid-nintendo-Kernelmodul, auf den meisten Distros vorhanden), 8BitDo Pro 2, Xbox Wireless via xpadneo und mehr.

Maussteuerung statt Gyro:

Settings → Input → Gyro → Gyro Input Method → Mouse

Spielstand-Speicherort

~/.local/share/TwilitRealm/Dusklight/USA/Card A/01-GZ2E01-gczelda2.gci

Für die PAL-Disc USA durch EUR ersetzen. (Dusklight migriert Spielstände beim ersten Start automatisch aus dem alten Dusk-Ordner.)

Falls ~/.local/share/TwilitRealm/Dusklight/ nach dem ersten Start nicht existiert, lies den #818-Abschnitt zur Fehlerbehebung weiter unten.

Von Dolphin migrieren

Dolphin-Spielstände unter Linux: ~/.local/share/dolphin-emu/GC/USA/Card A/01-GZ2E01-gczelda2.gci. In Dusklights Ordner kopieren. Dusklight neu starten.

Distro-spezifische Hinweise

Ubuntu / Debian

Funktioniert auf 22.04+ out of the box. Auf älteren Releases muss libsdl3-0 möglicherweise aus einem Backports-Repository installiert oder SDL3 aus dem Quellcode gebaut werden.

Arch / Manjaro

Funktioniert. Sicherstellen, dass vulkan-tools und das passende Treiber-Paket (vulkan-radeon oder nvidia-utils) installiert sind.

Fedora

Funktioniert. Vulkan-Setup wie bei Arch.

NixOS

Das Repo enthält eine flake.nix und flake.lock. Das Bauen aus dem Quellcode ist der unterstützte Weg.

Andere Distros

Den Binary ausprobieren; falls Vulkan nicht klappt, das Grafik-Backend in Settings → Prelaunch umstellen.

Häufige Probleme

„Couldn’t create directory ‘/TwilitRealm’: Permission denied”

Das war ein früher AppImage-Varianten-Bug (#818). Da AppImage jetzt das offizielle Linux-Format ist, wurde das zugrunde liegende Verhalten angepasst. Falls du das unter v1.4.1 noch siehst, ein neues Issue eröffnen und ein eventuell verwaistes /TwilitRealm-Verzeichnis im Root aufräumen: sudo rm -rf /TwilitRealm (nur, wenn du sicher bist, dass der Pfad von dir stammt).

Vulkan nicht gefunden

mesa-vulkan-drivers (Ubuntu/Debian) oder vulkan-radeon/nvidia-utils (Arch) installieren und neu starten. Oder in Settings → Prelaunch → Graphics Backend auf OpenGL wechseln.

Kein Ton

Die meisten Distros nutzen PipeWire als Standard; Dusklight sollte das automatisch erkennen. Falls nicht, pipewire-pulse für den PulseAudio-Kompatibilitäts-Shim installieren.

Spiel läuft, aber Tastenbelegung funktioniert nicht

Die Linux-Tastenbelegung funktioniert laut Meldungen korrekt (der macOS-Bug #830 ist macOS-spezifisch). Falls du doch Probleme mit der Tastenbelegung unter Linux hast, die GitHub-Issues auf neuere Meldungen prüfen.

Ruckelt bei entsperrter Framerate

Bekanntes Problem: pulsierendes Bloom-Artefakt bei entsperrter Framerate (#825). Entweder Framerate sperren oder das visuelle Artefakt vorerst akzeptieren.

Aus dem Quellcode bauen

Laut docs/building.md:

Ubuntu 24.04, Arch, Fedora werden unterstützt
CMake 3.25+
Python 3+
Build-Presets: linux-default-relwithdebinfo, linux-default-debug, linux-clang-relwithdebinfo, linux-clang-debug

Häufige Probleme unter Linux

„Couldn’t create directory ‘/TwilitRealm’: Permission denied” (AppImage) → #818-Fix
Hash-Verifizierung fehlgeschlagen → Leitfaden
Nicht unterstütztes Spiel → Region-Leitfaden
Steckt bei 30 FPS fest → Checkliste
Dolphin-Spielstand lädt nicht → Migrationsleitfaden
Alle bekannten Probleme → Übersicht bekannter Probleme

Was als nächstes?

🎨 Henriko-Magnifico-4K-Texture-Pack installieren (Pfad: ~/.local/share/TwilitRealm/Dusklight/texture_replacements/)
🚀 Framerate & 60 FPS erklärt
💾 Spielstand-Pfade & geräteübergreifende Synchronisierung
🎮 Steam-Deck-Anleitung (nutzt denselben Linux-x86_64-Build)

Zuletzt aktualisiert: 20. Juni 2026. Wir aktualisieren diese Anleitung, wenn Linux-spezifische Patches erscheinen.

← Alle Installationsanleitungen · Hauptseite →