Skip to content
Dusk Guide

iOS

Twilight Princess Dusk on iOS via AltStore

iOS doesn't allow direct sideload, so the install goes through AltStore — a Mac signs the IPA with your Apple ID. This page mirrors the official iOS install guide in the Dusk repo, with the surrounding context that trips most people up.

UPDATED 2026-05-119 minAdvanced

Independent guide

Independent fan-made guide. Not affiliated with Nintendo, The Legend of Zelda, Twilight Princess, Twilit Realm, or Dusk. We do not host, link to, sell, mirror, or distribute ROMs, ISOs, disc images, game files, copyrighted assets, keys, cracks, or bypass tools. Use your own legally obtained copy.

What you need first

  • A Mac with Homebrew installed. (Yes — a Mac is required. AltServer is Mac-only on this path.)
  • An iPhone running iOS 16+ with a Lightning or USB-C cable for pairing.
  • An Apple ID (a free Apple ID works; paid developer account not required).
  • The Dusk IPA: Dusk-v1.0.0-ios-arm64.ipa (26.7 MB) from the official release.
  • A legally obtained dump of Twilight Princess — GameCube USA (GZ2E01) or PAL (GZ2PE01).
  • Patience. There are several Apple-side prompts and you'll bounce between Mac and iPhone.

1 — Install AltServer on your Mac

From a Mac terminal:

brew install altserver
open -a AltServer

AltServer appears as a small icon in your menu bar. Leave it running for the rest of the steps.

2 — Enable Developer Mode (iOS 16+)

  1. On your iPhone: Settings → Privacy & Security → Developer Mode.
  2. Toggle it on.
  3. Restart the iPhone when prompted.

3 — Install AltStore on iPhone

  1. Connect the iPhone to the Mac with a cable. Trust the Mac if prompted.
  2. Click the AltServer icon in the Mac menu bar → Install AltStore → [Your iPhone].
  3. Enter your Apple ID credentials when prompted. (App-specific password required if your account has 2FA — generate one at appleid.apple.com.)
  4. On the iPhone: Settings → General → VPN & Device Management.
  5. Tap your Apple ID under “Developer App” → tap Trust.

AltStore should now open on the iPhone.

4 — Transfer the IPA + dump to iPhone

Both files need to be reachable from the iPhone’s Files app. Pick whichever transfer is easiest:

  • AirDrop: right-click each file on the Mac → Share → AirDrop → your iPhone.
  • iCloud Drive: drop the files into iCloud Drive on the Mac; they sync into the Files app on the iPhone.
  • USB / Finder: with the iPhone connected, open Finder on the Mac → select the iPhone in the sidebar → Files tab → drag files in.
  • Cloud storage: Google Drive / Dropbox / etc. on the Mac, download to Files on the iPhone.

5 — Install Dusk via AltStore

  1. Open AltStore on the iPhone.
  2. Go to the My Apps tab.
  3. Tap the + button (top left).
  4. The Files app opens; navigate to where you put the Dusk-v1.0.0-ios-arm64.ipa and select it.
  5. AltStore signs the IPA with your Apple ID and installs it. Wait until the progress bar finishes.

6 — Launch + Select Disc Image

  1. Find Dusk on your Home Screen and tap it.
  2. Tap Select Disc Image; navigate to where you put your supported dump in the Files app, and select it.
  3. Tap Play.

7-day re-sign cycle

If you’re stuck

  • AltServer doesn’t see the iPhone → check the cable, trust the Mac on iPhone, ensure same Wi-Fi network for wireless mode.
  • Apple ID prompt rejects credentials → try an app-specific password if your account has 2FA.
  • AltStore install hangs at signing → restart AltStore and try again; if it persists, check GitHub issues.
  • Dusk crashes on launch → confirm your dump is supported via supported versions and the file is reachable in the Files app.
  • Anything else — official Discord discord.gg/dusktp is the right channel for iOS-specific edge cases.

Source for the install flow: the official iOS AltStore guide in the Dusk repo. We mirror its steps and add the surrounding gotchas. If anything diverges, the official document wins.

Related guides