DuskPort

Dusklight auf iOS installieren — AltStore-Sideload-Anleitung

Dusklight auf iPhone oder iPad per AltStore sideloaden. Vollständige Schritt-für-Schritt-Anleitung: iOS 16+ Developer-Modus, 7-Tage- vs. 1-Jahres-Zertifikat.

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

iOS erlaubt keine Apps außerhalb des App Stores, daher nutzt Dusklight AltStore für das Sideloading. Diese Anleitung basiert auf der offiziellen docs/ios-install-altstore.md aus dem Dusklight-Repo und ergänzt Kontext für Dinge, die die offizielle Doku überspringt (Controller koppeln, Spielstand-Speicherort, das 7-Tage-Zertifikat-Dilemma).

Zeitaufwand: ~20 Minuten beim ersten Setup Schwierigkeitsgrad: Mittel (mehr Schritte als Android, wegen Apples Sandboxing)

⚠️ Zuerst lesen (aktualisiert für v1.4.1)

Eine Sache vorab: Kostenlose Apple ID = App läuft 7 Tage. Mit dem kostenlosen Weg musst du Dusklight jede Woche über AltStore erneuern. Verpasst du eine Woche, startet die App nicht mehr, bis du sie erneuerst.

Wer das wöchentliche Erneuern vermeiden will: Ein kostenpflichtiges Apple Developer Program ($99/Jahr) gibt 1-Jahres-Zertifikate statt 7-Tage-Zertifikate. Die meisten Nutzer starten mit dem kostenlosen Weg und upgraden, wenn es nervt.

✅ iOS-Spielstand-Zugriff ist längst repariert. Der frühere Sandbox-Zugriffs-Stolperstein (#804) ist geschlossen. Ab dem aktuellen v1.4.1-Build erscheinen Dusklight-Daten in der Files-App unter Auf meinem iPhone → Dusklight, und Einstellungen → Interface → Open Data Folder springt direkt dorthin. Den Finder-Backup-Workaround aus älteren Anleitungen ignorieren.

Voraussetzungen (laut offizieller Doku)

Exakt so in docs/ios-install-altstore.md festgehalten:

  • Ein Mac mit installiertem Homebrew
  • Dein per USB verbundenes iPhone
  • Dusklight-IPA: Dusklight-v1.4.1-ios-arm64.ipa von den GitHub-Releases (25,9 MB)
  • Disc-Dump: GameCube USA (GZ2E01) oder GameCube PAL (GZ2P01)

In der aktuellen docs/ios-install-altstore.md im offiziellen Repo steht die PAL-ID als GZ2PE01 — das ist ein Tippfehler mit 7 Zeichen. Alle echten GameCube-Spiel-IDs haben 6 Zeichen (4-Zeichen-Produkt + 2-Zeichen-Verlag „01”), und die korrekte PAL-ID lautet GZ2P01. Der PAL-Disc-Dump funktioniert, solange sein SHA-1 2601822a488eeb86fb89db16ca8f29c2c953e1ca entspricht.

Schritt 1 — AltServer auf dem Mac installieren

Laut offizieller Doku:

brew install altserver
open -a AltServer

Nach dem Start erscheint AltServers Symbol in der Menüleiste (oben rechts auf dem Mac). Für den Rest des Setups laufen lassen.

Falls AltServer nicht in der Menüleiste erscheint: Systemeinstellungen → Anmeldeoptionen → sicherstellen, dass AltServer erlaubt ist.

Schritt 2 — Developer-Modus auf iOS aktivieren (iOS 16+)

Auf dem iPhone:

  1. Einstellungen → Datenschutz & Sicherheit → Entwickler-Modus
  2. Einschalten
  3. iPhone neu starten, wenn aufgefordert

Ohne diesen Schritt starten sideloaded Apps auf iOS 16 oder neuer nicht.

Schritt 3 — AltStore auf dem iPhone installieren

Mit per USB verbundenem iPhone:

  1. Das AltServer-Symbol in der Mac-Menüleiste anklicken
  2. AltStore installieren → [Dein iPhone] anklicken
  3. Apple ID und Passwort eingeben, wenn gefragt (diese Apple ID signiert die sideloaded Apps neu)
  4. Warten, bis AltStore auf dem Smartphone installiert ist

Dann auf dem iPhone:

  1. Einstellungen → Allgemein → VPN & Geräteverwaltung
  2. Deine Apple ID unter „Entwickler-App” antippen
  3. Vertrauen antippen

AltStore sollte jetzt als App auf dem Home-Screen erscheinen.

💡 Kostenlose vs. kostenpflichtige Apple ID: Bei einer kostenlosen Apple ID verfallen sideloaded Apps (einschließlich Dusklight) nach 7 Tagen und müssen über AltStore erneuert werden. Ein kostenpflichtiges Apple Developer Program ($99/Jahr) gibt 1-Jahres-Zertifikate und erlaubt mehr gleichzeitig signierte Apps.

Schritt 4 — Dateien auf das iPhone übertragen

Sowohl die Dusklight-IPA als auch das GameCube-Disc-Image müssen auf das iPhone.

Die offizielle Doku nennt vier Übertragungsmethoden:

AirDrop

Auf dem Mac jede Datei rechtsklicken → Teilen → AirDrop → iPhone auswählen. Dateien landen in der Files-App.

iCloud Drive

Dateien in iCloud Drive auf dem Mac ablegen. Sie synchronisieren automatisch in die Files-App auf dem iPhone.

USB-Übertragung (Finder-Sidebar)

iPhone verbunden → Finder → iPhone in der Sidebar anklicken → Dateien-Tab → Dateien auf den Bereich einer kompatiblen App ziehen.

Cloud-Speicher

Auf Google Drive, Dropbox, OneDrive usw. auf dem Mac hochladen. Über die passende App auf dem iPhone herunterladen.

⚠️ Disc-Images sind ~1 GB. AirDrop und USB-Übertragung sind am schnellsten. iCloud / Cloud-Uploads verbrauchen auf beiden Seiten Datenvolumen.

Schritt 5 — Dusklight über AltStore installieren

  1. AltStore auf dem iPhone öffnen
  2. Tab Meine Apps antippen
  3. +-Button antippen (oben links)
  4. Der Files-Browser öffnet sich
  5. Zu Dusklight-v1.4.1-ios-arm64.ipa navigieren (Files-App oder wo immer gespeichert)
  6. Antippen zum Auswählen

AltStore signiert und installiert Dusklight. Das dauert 30–60 Sekunden. Dusklight erscheint auf dem Home-Screen.

Schritt 6 — Erster Start

  1. Dusklight auf dem Home-Screen antippen
  2. Im Vorstart-Bildschirm erscheint der Button Disc-Image auswählen
  3. Antippen. Der iOS-Files-Picker öffnet sich.
  4. Zum GameCube-Disc-Image navigieren (Files → Auf meinem iPhone, oder iCloud Drive, oder wo auch immer)
  5. Antippen zum Auswählen
  6. Dusklight prüft den Hash (XXH128 gegen die eingebaute Tabelle)
  7. Status wechselt zu „Disc ready.”
  8. Play antippen

Schritt 7 — Controller koppeln (empfohlen)

iOS unterstützt MFi-zertifizierte Controller und viele Bluetooth-Gamepads:

ControllerHinweis
Backbone OneiPhone-Clip; funktioniert nativ
Xbox Wireless (Modell 1914+)Natives Bluetooth-Pairing
DualShock 4 / DualSenseNatives Pairing ab iOS 13+
Switch Pro ControlleriOS 16+ via Bluetooth
8BitDo Pro 2Bluetooth, Gyro-Support
Razer Kishi V2Smartphone-Clip, als MFi erkannt

Koppeln:

  1. iPhone-Einstellungen → Bluetooth → Koppeln
  2. Controller in den Pairing-Modus versetzen (Tastenkombination je nach Controller)
  3. Einmal gekoppelt, funktioniert der Controller automatisch in Dusklight

In Dusklight:

Einstellungen → Input → Controller → Controller konfigurieren

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

Einstellungen → Input → Gyro → Gyro Aim → einschalten

Ab v1.4.0 bietet Dusklight nativen Gyro und Rumble auf iOS — die eigenen Sensoren des iPhones/iPads können Gyro-Aim antreiben, ein Gyro-fähiger Controller ist also nicht mehr erforderlich. v1.4.0 bringt außerdem erstklassige mobile Touch-Controls, sodass auch ganz ohne Gamepad gespielt werden kann.

Spielstand sichern (jetzt einfach)

Issue #804 ist geschlossen — Dusklight-Daten sind in der iOS-Files-App sichtbar.

Spielstand finden oder sichern:

  1. In Dusklight: Einstellungen → Interface → Open Data Folder — springt direkt zum iOS-Files-Speicherort
  2. Über die Files-App: Auf meinem iPhone → Dusklight-Ordner → enthält USA/ (oder EUR/) → Card A/01-GZ2*-gczelda2.gci
  3. Die .gci-Datei lang drücken → Teilen → per AirDrop auf den Mac oder in iCloud Drive kopieren

Der frühere Finder-Verschlüsselungs-Backup-Workaround ist hinfällig. Direkt die Files-App nutzen.

Migration von Dolphin: .gci per AirDrop vom Mac auf das iPhone schicken (landet in Auf meinem iPhone → Downloads), dann nach Auf meinem iPhone → Dusklight → USA → Card A → verschieben (oder EUR für PAL).

Häufige Probleme

„Nicht vertrauenswürdiger Entwickler” beim ersten Start

Schritt 3’s Vertrauen-Aktion wurde übersprungen. Einstellungen → Allgemein → VPN & Geräteverwaltung → [Deine Apple ID] → Vertrauen.

Dusklight startet nicht — „App ist nicht mehr verfügbar”

Das 7-Tage-Zertifikat ist abgelaufen. AltStore öffnen → Meine Apps → Erneuern neben Dusklight antippen. Der Mac muss dabei AltServer laufen haben und im selben WLAN wie das iPhone sein.

„App konnte nicht installiert werden” über AltStore

Häufige Ursachen:

  • Kostenlose Apple ID hat das 3-App-Limit erreicht (nur 3 sideloaded Apps gleichzeitig erlaubt). Andere entfernen.
  • AltServer läuft nicht auf dem Mac
  • iPhone nicht im selben WLAN wie der Mac
  • Apple-ID-2FA-Anfrage hat den Vorgang unterbrochen

Disc-Image im Files-Picker nicht gefunden

Der Picker zeigt nur Cloud-aware-Ordner an. Das Disc-Image muss unter Auf meinem iPhone, iCloud Drive oder Dokumente liegen — nicht in einer cloud-only-Fotomediathek oder einem App-privaten Ordner.

Performance schlechter als erwartet

Dusklight bietet derzeit keine iOS-spezifischen Performance-Einstellungen. Folgendes ausprobieren:

  • Interne Auflösung in Einstellungen → Video reduzieren
  • Framerate entsperren deaktivieren, wenn das Gerät thermisch drosselt
  • Sicherstellen, dass der Energiesparmodus ausgeschaltet ist

Bluetooth-Controller funktioniert in anderen Apps, aber nicht in Dusklight

Manche Controller werden als MFi vs. HID unterschiedlich erkannt. Entkoppeln und neu koppeln versuchen. In Dusklight unter Einstellungen → Input → Controller → Controller konfigurieren prüfen, ob Dusklight ihn erkennt.

Alternative Sideload-Methoden (nicht offiziell unterstützt)

Die offizielle Doku behandelt nur AltStore. Community-Alternativen:

  • SideStore — wie AltStore, aber kein laufender AltServer / Mac nötig für das Erneuern. Läuft komplett auf dem Gerät per „VPN-Trick”.
  • Sideloadly — Windows-freundliche Mac-Alternative.
  • TrollStore (nur Jailbreak) — für ältere iOS-Versionen; permanente Installation ohne Neu-Signierung. Nur auf bestimmten iOS-Versionen verfügbar.

Nutzung auf eigene Gefahr; von TwilitRealm nicht validiert. Der AltStore-Weg in der offiziellen Doku ist der sicherste.

Bekannte Probleme auf iOS

  • Spielstand in Files-App nicht sichtbar (#804) — behoben; Files → Auf meinem iPhone → Dusklight → USA → Card A nutzen
  • App nach 7 Tagen abgelaufen (kostenlose Apple-ID-Zertifikat) — über AltStore vom Mac neu signieren
  • Hash-Prüfung fehlgeschlagen → Fehlerbehebung
  • Spielstand auf PC / Mac synchronisieren → Geräteübergreifende Sync-Anleitung
  • Alle Probleme → Bekannte Probleme

Nächste Schritte

Zuletzt aktualisiert: 2026-06-20. Basiert auf der offiziellen docs/ios-install-altstore.md aus dem Dusklight-Repo, aktualisiert für v1.4.1.

← Alle Installationsanleitungen · Hauptseite →