DuskPort

Dusklight auf dem Steam Deck installieren (Twilight Princess)

Schritt-für-Schritt-Anleitung für Dusklight auf dem Steam Deck: verifizierbarer Setup-Ablauf, native Gyro-Steuerung und aktuelle Performance-Daten.

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

Der Steam Deck läuft Dusklight über den Linux x86_64-Build. Die Einrichtung ist unkompliziert und folgt dem üblichen Muster „Als Nicht-Steam-Spiel hinzufügen”, das für andere Linux-Anwendungen auf dem Deck genauso funktioniert.

Diese Anleitung ist gegen den Dusklight-Quellcode, die offizielle FAQ und das Review von Steam Deck HQ (dem bisher einzigen veröffentlichten Deck-Benchmark) geprüft.

Zeitaufwand: ~10–15 Minuten Schwierigkeitsgrad: Einfach

Was du brauchst

  1. Einen Steam Deck (LCD oder OLED — beide nutzen denselben Linux x86_64-Build)
  2. Einen eigenen, legal ausgelesenen GameCube-TP-Disc-Dump in einem der unterstützten Formate (ISO, GCM, CISO, GCZ, NFS, RVZ, WBFS, WIA, TGC). Falls du noch keinen hast: Disc legal auslesen – Anleitung
  3. Ein paar Minuten im Desktop-Modus

Schritt 1 — In den Desktop-Modus wechseln

  1. STEAM-Taste drücken
  2. Einschalten auswählen
  3. Zum Desktop wechseln auswählen

Das Deck startet in KDE Plasma neu. Das rechte Trackpad dient als Maus, der rechte Trigger als Linksklick, und STEAM + X öffnet eine Bildschirmtastatur.

Schritt 2 — Den Linux-Build herunterladen

  1. Firefox öffnen
  2. Zu github.com/TwilitRealm/dusklight/releases gehen
  3. Unter v1.4.1 Assets die Datei Dusklight-v1.4.1-linux-x86_64.AppImage herunterladen (~32 MB)

Dusklight wird als einzelne AppImage-Datei ausgeliefert statt als .zip — praktischer auf dem Deck. Wer die Integrität prüfen möchte, berechnet den SHA-256 mit sha256sum und vergleicht ihn mit der offiziellen Release-Seite.

Schritt 3 — Ausführbar machen

  1. Konsole (Terminal) über das Startmenü unter „System” öffnen
  2. AppImage ausführbar machen und an einen stabilen Ort verschieben: 
    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/
  3. Den Disc-Dump in einen leicht merkbaren Ordner legen: 
    mkdir -p ~/Games/TwilightPrincess
    Dann das Disc-Image per Drag-and-drop über den Dolphin-Dateimanager (KDEs eigener — nicht der GameCube-Emulator) dorthin ziehen.

Schritt 4 — Als Nicht-Steam-Spiel hinzufügen

  1. Den Steam-Desktop-Client öffnen (Verknüpfung auf dem Desktop)
  2. Spiele → Nicht-Steam-Spiel zu meiner Bibliothek hinzufügen…
  3. Durchsuchen… und ~/Applications/Dusklight-v1.4.1-linux-x86_64.AppImage auswählen
  4. Ausgewählte Programme hinzufügen klicken

Optional zur Verschönerung:

  • Rechtsklick auf den Eintrag → Eigenschaften → in „Dusklight: Twilight Princess” umbenennen
  • Cover-Art von SteamGridDB hinzufügen — Dusklight-Artwork ist bereits hochgeladen

Schritt 5 — Zurück in den Gaming-Modus

  1. Zurück zum Gaming-Modus auf dem Desktop doppelklicken
  2. Das Deck startet in die normale Steam-Oberfläche
  3. Dusklight in der Bibliothek suchen
  4. A drücken zum Starten

Beim ersten Start öffnet sich das Dusklight-Vorstart-Menü. Disc-Image auswählen markieren, A drücken und den Disc-Dump im Datei-Dialog auswählen. Dusklight prüft den Hash, zeigt „Disc ready.” an, und der Button wechselt zu Play.

Schritt 6 — Controller und Gyro-Steuerung einrichten

Das Standard-GameCube-Layout des Decks funktioniert ohne weitere Konfiguration. Wer anpassen möchte — die verifizierten Pfade:

Natives Gyro-Aim aktivieren (empfohlen)

Einstellungen → Input → Gyro → Gyro Aim → einschalten

Dann Gyro Input Method → Sensor (liest direkt die IMU des Decks)

Gyro Pitch Sensitivity, Gyro Yaw Sensitivity und Gyro Deadband nach Geschmack anpassen.

Oder stattdessen Maussteuerung verwenden

Einstellungen → Input → Gyro → Gyro Input Method → Mouse

Damit wird der Input über eine virtuelle Maus geleitet, die Steam Input mit dem Gyro des Decks ansteuern kann — falls du Steams Gyro-zu-Maus-Funktion bevorzugst.

Trackpad als Zielsteuerung

Wer lieber das rechte Trackpad zum Zielen nutzt: Gyro Aim deaktivieren und die Steam-Input-Mausbelegung des Decks verwenden.

⚠️ Immer nur eine Gyro-Methode gleichzeitig verwenden. Nativer Sensor + Steam-Input-Gyro-zu-Maus beißen sich gegenseitig.

Wichtige Deck-Einstellungen auf einen Blick

EinstellungPfad
Vollbild umschaltenEinstellungen → Video → Anzeige → Vollbild umschalten
FPS-Anzeige einblendenEinstellungen → Video → Anzeige → FPS-Anzeige einblenden
Framerate entsperrenEinstellungen → Video → Rendering → Framerate entsperren
Interne AuflösungEinstellungen → Video → Auflösung → Interne Auflösung
4:3-Seitenverhältnis sperrenEinstellungen → Video → Anzeige → 4:3-Seitenverhältnis sperren

Performance: Was tatsächlich bekannt ist

Zwei verifizierte Datenpunkte (Stand 2026-05-13):

„Selbst beim Hochdrehen auf 90 FPS bleibt der Akkuverbrauch unter 11 W.” — Steam Deck HQ, 2026-05-10

„Auf dem Steam Deck OLED sind stabile 60 fps in nativer Auflösung mit deutlichem Spielraum zu erwarten.” — Held Games, 2026-05-11 (qualitativ)

Das war’s. Keine Akkulaufzeit in Stunden, keine offengelegten Einstellungen, keine TDP-FPS-Kurve. Kein Deck-spezifisches Dusklight-Video von ETA Prime / The Phawx / Retro Game Corps ist bisher aufgetaucht. Diesen Abschnitt aktualisieren wir, sobald weitere verifizierte Benchmarks vorliegen.

Was man vernünftigerweise ableiten kann (aber nicht verifizieren):

  • Der GameCube lief TP mit 30 FPS-Ziel auf 485-MHz-Hardware. Die moderne Deck-Silizium ist dramatisch schneller.
  • Angestrebte Framerate des Projekts: „bis zu 120 FPS” (Time Extension Vorveröffentlichungs-Berichterstattung). Das ist ein Designziel, keine gemessene Obergrenze auf dem Deck.
  • Die Akkuzeit hängt stark vom Framerate-Cap, dem TDP-Setting und der Bildwiederholrate ab. Einfach ausprobieren und anpassen.

Spielstände auf dem Steam Deck

Laut offizieller FAQ (twilitrealm.dev/faq):

  • Linux-Speicherpfad: ~/.local/share/TwilitRealm/Dusklight/USA/Card A/
  • USA durch EUR ersetzen bei PAL-Disc
  • Dateiname des Spielstands: 01-GZ2*-gczelda2.gci

Falls du TP bereits in Dolphin auf dem PC gespielt hast und deinen Spielstand mitnehmen möchtest:

  1. Dolphin-GCI auf dem PC finden: Documents/Dolphin Emulator/GC/USA/Card A/01-GZ2E01-gczelda2.gci
  2. Per USB / Cloud / SCP auf den Deck kopieren
  3. In ~/.local/share/TwilitRealm/Dusklight/USA/Card A/ ablegen
  4. Dusklight neu starten — der Spielstand erscheint im Lade-Menü

Häufige Probleme

„Permission denied” beim Start über Steam

Der chmod +x-Schritt wurde übersprungen. chmod +x ~/Applications/Dusklight-v1.4.1-linux-x86_64.AppImage in der Konsole erneut ausführen.

Steam zeigt die Datei im Datei-Picker nicht an

Steams „Nicht-Steam-Spiel hinzufügen” kann Dateien ohne Dateiendung ausblenden. Im Datei-Picker die Dropdown-Liste auf Alle Dateien stellen.

Audio knistert

Den Audio-Backend-Wechsel (PulseAudio ↔ PipeWire) auf Systemebene des Decks ausprobieren.

Spiel läuft, aber Controller reagiert nicht

Steam Input hat den Controller möglicherweise für den Desktop-Modus übernommen. Im Spiel-Overlay öffnen → Controller-Einstellungen → Vorlagen → Gamepad auswählen, nicht Desktop.

Mein ROM-Dump wird abgelehnt

SHA-1 in der Konsole prüfen:

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

Muss mit 75edd3ddff41f125d1b4ce1a40378f1b565519e7 (NTSC-U) oder 2601822a488eeb86fb89db16ca8f29c2c953e1ca (PAL) übereinstimmen. Falls nicht, neu auslesen.

App versucht, ins Root-Dateisystem zu schreiben

Es gab einen bekannten frühen Linux-AppImage-Bug (#818) mit der Meldung:

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

Da AppImage jetzt der offizielle Linux-Distributions-Weg ist, wurde das behoben. Falls es auf v1.4.1 noch auftritt: Issue melden und den verwaisten /TwilitRealm-Ordner aufräumen (sudo rm -rf /TwilitRealm), falls er im Root existiert.

Abschluss-Checkliste

  • ✅ Dusklight startet aus dem Gaming-Modus
  • ✅ Titelbildschirm erscheint; Audio läuft
  • ✅ Disc verifiziert; Status zeigt Disc ready.
  • ✅ Gyro-Aim konfiguriert (nativer oder Maus-Modus)
  • ✅ Spielstand getestet (in Ordon Village speichern, neu starten, Laden prüfen)

Häufige Probleme auf dem Steam Deck

Nützliche Erweiterungen

Zuletzt aktualisiert: 2026-06-20. Diese Anleitung wird aktualisiert, sobald Deck-spezifische Patches und Benchmarks veröffentlicht werden.

← Alle Installationsanleitungen · Hauptseite →