LATEST

Install Dusk Light on iOS

Install the iOS ARM64 IPA with iloader or AltStore, trust the app in iOS settings, and place your supported dump where Files can expose it to Dusklight. v2.0.0 includes touch controls; installation, trust, and file access remain separate checks.

Last reviewed: September 19, 2026 against GitHub v2.0.0 and the official iOS guide

iOS IPA route

The official v2.0.0 iOS ARM64 IPA is 35.3 MiB. The official iOS guide offers AltStore with AltServer on Windows/macOS, or iloader over USB from Windows, macOS, or Linux. In AltStore, add the Twilit Realm source at twilitrealm.dev/apps.json. With iloader, install updates manually. Follow the guide for Developer Mode, app trust, and Files app access.

Install steps

  1. 01Download the iOS ARM64 IPA from the official TwilitRealm/dusklight release.
  2. 02Install Dusklight with AltStore or iloader. The official iOS guide has the dedicated sideloading flow.
  3. 03Trust the installed app in iOS settings if your device asks.
  4. 04Transfer your supported personal GameCube or Wii (except Korean Wii) dump to a Files app location, then open Dusklight and choose Select Disc Image.

Before you start

iOS ARM64 IPA

The current official file is Dusklight-v2.0.0-ios-arm64.ipa. Avoid repackaged IPAs, because sideloaded apps already require enough trust decisions without adding an unknown mirror.

AltStore or iloader

AltStore uses AltServer on Windows or macOS and the Twilit Realm source. iloader uses a USB connection from Windows, macOS, or Linux; its updates require another installation.

Developer Mode and trust

On iOS 16+, Developer Mode must be enabled. After installation, iOS also requires trusting the app under VPN & Device Management before it launches.

Files app access

The guide tells users to transfer the game disc image so it is accessible in the Files app. AirDrop, iCloud Drive, USB transfer, and cloud storage are all mentioned as possible transfer paths.

Check the IPA and install path

iOS installation has more moving parts than desktop, so keep a clear record: official IPA, current iOS guide, Developer Mode, trust step, and Files app location. These commands are for the computer used to stage or inspect the IPA.

Record the IPA hash

shasum -a 256 ./Dusklight-v2.0.0-ios-arm64.ipa

Run this on macOS or another shell with shasum before importing the IPA into iloader. GitHub release asset metadata includes SHA-256 information for audit-minded users.

Confirm the IPA file size

ls -lh ./Dusklight-v2.0.0-ios-arm64.ipa

GitHub lists the v2.0.0 iOS ARM64 IPA at 35.3 MiB. If your file is wildly different, re-check the download source.

Inspect IPA contents without installing

unzip -l ./Dusklight-v2.0.0-ios-arm64.ipa | head

This is a harmless sanity check on the staging computer. It should show that the IPA is a zip-style iOS app package, not a random renamed download.

iOS notes

  • Follow the current official iOS installation guide. Its disc list may lag behind the release: use the v2.0.0 tagged README for GameCube/Wii support and the Korean Wii exception.
  • Developer Mode, device trust dialogs, and VPN & Device Management trust are separate iOS steps. Missing one can look like the app is broken.
  • Do not trust repackaged IPAs from unofficial mirrors. The expected source is the official GitHub release asset.
  • Files app access is usually the main setup friction point after installation. Put the supported dump somewhere iOS can expose to Dusklight.
  • Dusk Light does not host ROMs, ISOs, IPAs, disc images, copyrighted textures, or replacement game assets.

Other official builds

iOS ARM64 IPA

Explore same-language install pages

Stay in this language while comparing Dusk Light downloads, file sizes, update times, and platform notes.

What changed in v2.0.0

Released September 19, 2026

GitHub marks v2.0.0 as the latest stable release. Its iOS ARM64 IPA is 35.3 MiB.

Touch, gyro, and rumble

v1.4.0 added customizable touch controls, touch support in menus, and native gyro and rumble on iOS.

Touch targeting and save backups

v2.0.0 adds Hybrid, Hold, and Switch touch targeting, the mod browser, and Save Manager with .dusksave, .gci, and .raw support. Back up saves before updating. Earlier v1.4.1 fixed keyboard focus and added Clawshot hanging and Hawkeye touch support; those remain historical changes.

iOS issue tracker notes

Issue #1595: ProMotion frame cap

Open

An iOS report says ProMotion devices could switch between 120 fps and 80 fps caps after interruptions such as screenshots, control center, or area loads. It is useful evidence for tracking frame-rate settings carefully.

Open source

Issue #1597: settings reset after updates

Open

A Platform-iOS report says app updates reset client settings while game files remained intact. iOS users should record visual and input settings before updating.

Open source

Issue #1636: random startup crashes

Open

An iOS issue describes occasional crashes on startup. It does not mean every install is unstable, but it is a reason to keep installation method and device details ready for reports.

Open source

Issue #1854: no device assigned dialog

Completed

A completed iOS report described the no device assigned dialog remaining after assigning a device, plus Files app trouble while selecting a redump. It is closed, but it explains why input and file-picker setup deserve their own page section.

Open source

Source of truth

All files listed here point to the official TwilitRealm/dusklight GitHub release assets. Dusk Light does not mirror binaries or host copyrighted game data.