DuskPort

Dusklight auf Android installieren — Twilight Princess PC-Port

Dusklight als APK auf Android sideloaden: APK-Installation, ROM-Dateiauswahl, Bluetooth-Controller einrichten und aktuelle bekannte Probleme.

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

Dusklight kam mit einer nativen ARM64-APK für Android. Es gibt keinen Play-Store-Eintrag — du lädst die APK direkt von der offiziellen GitHub-Release-Seite. Diese Anleitung erklärt, wie das geht.

Zeitaufwand: ~5 Minuten Schwierigkeitsgrad: Einfach

⚠️ Stand v1.4.1 (2026-06-16)

Die Kinderkrankheiten des Launch-Tages sind längst behoben — mit dem aktuellen v1.4.1-Build bist du an all dem vorbei:

  • ✅ Ilia ohne Haare (#827) — behoben; der Adreno Alpha-Discard-Workaround ist seit Langem ausgerollt
  • ✅ Spielstand-Daten im Files-App sichtbar + Einstellungen → Interface → Open Data Folder-Menü (schließt #804)
  • ✅ Initialer Pipeline-Cache wird jetzt korrekt kopiert (einmalig pipeline_cache.db löschen zum Auffrischen, danach weniger Pop-in-Glitches)
  • ⏳ Snapdragon 8 Elite Gen 5 / Adreno 840 — noch einige offene Probleme (verzerrte Texturen, Vertex-Bugs, LOD-Glitches): #801 (Galaxy S26 Ultra „Käsefaden”), #750, #846, #1184. Das offizielle README räumt ein: „we are also aware of a number of issues on devices with Adreno GPUs and are working to resolve them.”

Installiere den aktuellen v1.4.1-Build unten — diese Fixes sind bereits enthalten.

Voraussetzungen

1. Ein aktuelles Android-Smartphone (Controller optional)

Ab v1.4.0 liefert Dusklight erstklassige mobile Touch-Controls mit — ein anpassbares On-Screen-Steuerungsschema für Android, sodass ein Gamepad nicht mehr zwingend nötig ist. Das frühe Launch-Feedback sprach noch für einen physischen Controller, und viele Spieler bevorzugen einen aus Komfortgründen:

„you need a controller to play it, i was able to get it running at max settings, not sure if its because of the frame rate or the phone version not being as polished but Ilia was missing her hair lol” — splashtext, r/SteamDeck (43 Upvotes)

Dieser Hinweis stammt aus der Zeit vor v1.4.0’s Touch-Controls. Probiere erst das On-Screen-Layout; greif zum Controller, wenn du ihn willst.

Geräte, die beim Launch bestätigt funktionierten:

  • Die meisten modernen Snapdragon- / Tensor-Flaggschiffe (Galaxy S, Pixel 8+)
  • Retroid Pocket 5, Retroid Pocket Flip 2 (Handheld)
  • AYN Thor (Handheld)

2. Nur ARM64

Dusklight liefert nur eine arm64-APK. Auf sehr alten 32-Bit-Android-Geräten lässt sie sich nicht ausführen. Die meisten Android-Phones der letzten 5+ Jahre sind ARM64.

3. Eigener GameCube-Twilight-Princess-Disc-Dump

Pflicht. Siehe Disc legal auslesen – Anleitung — das geht am einfachsten auf einem Desktop-PC, danach per Transfer auf das Smartphone.

Unterstützt in v1.0.0:

  • GameCube USA (GZ2E01)
  • GameCube PAL (GZ2P01)

Schritt 1 — APK herunterladen

  1. Auf deinem Smartphone Chrome / Firefox öffnen
  2. Zu github.com/TwilitRealm/dusklight/releases gehen
  3. Unter v1.4.1 Assets auf Dusklight-v1.4.1-android-arm64.apk tippen (56,9 MB)
  4. Download abwarten

Verifizierter SHA-256 der offiziellen APK: (auf der GitHub-Release-Seite prüfen — wird mit jedem Release veröffentlicht)

⚠️ Dusklight nicht von „apkaward” / „APKmirror” / „Gratis-APK”-Seiten herunterladen. Diese können Malware enthalten. Die einzig sichere Quelle ist die offizielle GitHub-Release-Seite.

Schritt 2 — APK-Sideload erlauben

Android blockiert APK-Installationen standardmäßig. Du musst es gezielt für den Browser erlauben, mit dem du die Datei heruntergeladen hast.

  1. Nach dem Antippen der heruntergeladenen APK zeigt Android: „Aus Sicherheitsgründen ist die Installation unbekannter Apps aus dieser Quelle auf Ihrem Gerät nicht erlaubt.”
  2. Einstellungen antippen
  3. Aus dieser Quelle zulassen einschalten
  4. Zur Download-Benachrichtigung zurückkehren, APK erneut antippen
  5. Installieren tippen

Danach kann „Aus dieser Quelle zulassen” wieder deaktiviert werden — sobald Dusklight installiert ist, wird die Option nicht mehr benötigt.

Schritt 3 — ROM übertragen

Die zuverlässigsten Methoden:

USB-Kabel

Smartphone per USB-C-Kabel mit dem Computer verbinden. Telefon auf Dateiübertragung stellen. Das Disc-Image (z. B. TwilightPrincess.iso) in einen Ordner auf dem Smartphone ziehen, etwa Interner Speicher/Download/ oder Interner Speicher/Documents/.

Cloud

Das Disc-Image auf dem Computer zu Google Drive oder Dropbox hochladen. Auf dem Smartphone die passende App installieren, einloggen und die Datei in den lokalen Speicher herunterladen. (Disc-Images sind ~1 GB — ausreichend Speicher und Datenvolumen sicherstellen.)

Kabelgebundene Übertragungs-Apps

LocalSend, Snapdrop oder AirDroid funktionieren alle für direkte LAN-Übertragung.

⚠️ ROM nicht auf einer SD-Karte im portablen Speichermodus ablegen — Androids Storage Access Framework (das Dusklight nutzt) kommt mit internem Speicher am besten zurecht. SD-Karten-Pfade erscheinen im Datei-Picker von Dusklight manchmal nicht.

Schritt 4 — Erster Start

  1. Die Dusklight-App öffnen
  2. Im Vorstart-Bildschirm erscheint der Button Disc-Image auswählen
  3. Antippen. Androids Files-/Storage-Access-Framework-Picker öffnet sich.
  4. Zum Disc-Image navigieren, antippen zum Auswählen
  5. Dusklight prüft den Hash (wenige Sekunden — XXH128 gegen die eingebaute Tabelle)
  6. Status wechselt zu „Disc ready.”
  7. Play antippen

Falls Dusklight deinen Dump ablehnt, erscheint eine dieser Meldungen:

  • „The selected disc image could not be validated.”
  • „The selected file is not a valid disc image.”
  • „The selected game is not supported by Dusklight.” (z. B. NTSC-J oder Wii)
  • „The selected disc image did not pass hash verification…”

Siehe SHA-1-Mismatch-Fehlerbehebung.

Schritt 5 — Controller koppeln

Dusklight unterstützt Standard-Bluetooth-Gamepads. Empfehlungen:

ControllerHinweis
Backbone OneiPhone-Style Clip-on; funktioniert als Bluetooth-Gamepad auf Android
GameSir X2 / G7Smartphone-Clip, gut getestet
8BitDo Pro 2Nativer Gyro-Support
Xbox Wireless (Modell 1914+)Natives Bluetooth-Pairing
DualShock 4 / DualSenseNatives Bluetooth-Pairing

Koppeln:

  1. Smartphone-Einstellungen → Bluetooth → Neues Gerät koppeln
  2. Controller in den Pairing-Modus versetzen (je nach Controller unterschiedlich)
  3. Einmal gekoppelt, Dusklight starten
  4. Controller funktioniert automatisch — kein weiterer Pairing-Schritt in Dusklight nötig

Konfiguration in Dusklight:

Einstellungen → Input → Controller → Controller konfigurieren

Gyro-Aim aktivieren (DualShock 4/5, Switch Pro, 8BitDo Pro 2):

Einstellungen → Input → Gyro → Gyro Aim (einschalten)

Ab v1.4.0 unterstützt Dusklight nativen Gyro und Rumble auf Android — die eigenen Bewegungssensoren des Smartphones können als Gyro-Quelle genutzt werden, ein Gyro-fähiger Controller ist also nicht mehr erforderlich.

Mobiles Menü-Kürzel

Dusklights UI-Überarbeitung (v0.6.0) hat eine mobile Geste hinzugefügt:

3-Finger-Tipp auf den Bildschirm blendet die Menüleiste ein oder aus.

Das ist in den v0.6.1-Release-Notes dokumentiert. Nützlich für den Zugriff auf Einstellungen, wenn kein Controller-Back/Select-Button vorhanden ist.

Spielstand-Speicherort auf Android (ab v1.4.1)

Dusklight-Daten sind über die Files-App zugänglich:

  • Einfachster Weg — in Dusklight: Einstellungen → Interface → Open Data Folder. Springt direkt an den richtigen Ort, unabhängig vom Gerät.
  • Manueller Pfad: /sdcard/Android/data/dev.twilitrealm.dusk/files/ — der Paket-Identifier ist dev.twilitrealm.dusk (nicht com.twilitrealm.dusk). Laut Issue #763 enthält dieser Ordner Spielstand-Daten und einen Texture_Replacement/-Unterordner für Mods.
  • adb-Backup (Desktop mit USB-Debugging): 
    adb pull /sdcard/Android/data/dev.twilitrealm.dusk/files/

Falls das Dusklight-Verzeichnis auf dem Smartphone schwer auffindbar ist, empfehlen TwilitRealms Release-Notes die Files-App von Marc — linke Navigation öffnen und ganz nach unten scrollen.

Häufige Probleme auf Android

„Ilia ohne Haare” / andere Modell-Glitches

Das war ein Launch-Tag-Bug in v1.0.0 (#827) — längst behoben durch einen Adreno Alpha-Discard-Workaround, der aktuelle v1.4.1-Build ist davon nicht betroffen. Wer es noch sieht, ist auf einem uralten Build; einfach den neuesten holen. Für weitere Rendering-Probleme auf Snapdragon 8 Elite / Adreno 840-Chips den GitHub-Issue-Tracker beobachten.

APK lässt sich nicht installieren

„Aus dieser Quelle zulassen” für den Browser/die App erneut aktivieren, mit der die APK heruntergeladen wurde. Einige Geräte erfordern Einstellungen → Apps → Spezieller App-Zugriff → Unbekannte Apps installieren für den jeweiligen Browser.

Disc-Image im Picker nicht sichtbar

SD-Karten-Speicher vermeiden; internen Speicher verwenden. Sicherstellen, dass die Dateiendung eine der folgenden ist: iso, gcm, ciso, gcz, nfs, rvz, wbfs, wia, tgc.

Controller gekoppelt, macht aber nichts in Dusklight

Manche Controller werden auf Android als Tastatur oder Maus erkannt. Smartphone-Einstellungen → Verbundene Geräte → Controller-Name → Modus prüfen — auf „Gamecontroller” stellen, falls verfügbar. Ansonsten einen anderen Controller probieren.

Performance ruckelt

Dusklight bietet kaum Android-spezifische Performance-Einstellungen. Folgendes ausprobieren:

  • Einstellungen → Video → Auflösung → Interne Auflösung auf native Smartphone-Auflösung oder darunter senken
  • Framerate bei 30 FPS deckeln via Einstellungen → Video → Rendering → Framerate entsperren (ausschalten)
  • Hintergrund-Apps schließen / Smartphone neu starten

Bekannte Probleme auf Android

  • Ilia ohne Haare (#827) — längst behoben; betrifft nur uralte Builds
  • Galaxy S26 Ultra / Adreno „Käsefaden”-Grafikfehler (#801) — offen; verfolgt im Dusklight-Repo
  • Spielstand in Files-App nicht sichtbar — behoben; Einstellungen → Interface → Open Data Folder nutzen
  • Spielstand auf PC synchronisieren → Geräteübergreifende Sync-Anleitung
  • Alle Probleme → Bekannte Probleme

Nächste Schritte

Zuletzt aktualisiert: 2026-06-20. Diese Anleitung wird aktualisiert, sobald Android-spezifische Patches erscheinen.

← Alle Installationsanleitungen · Hauptseite →