Where should I download Dusklight?

Use GitHub Releases and pick the file that matches your platform.

Does Dusklight include Twilight Princess game files?

No. You need a supported game file.

Which GameCube versions are supported?

North American NTSC and European PAL GameCube disc images are the supported targets noted in the project FAQ.

Should Steam Deck users follow the Linux guide?

Steam Deck uses the Linux AppImage route, but the Steam Deck guide adds Desktop Mode, Add to Steam, controller, and fullscreen checks.

Install hub

How to Install Dusklight

Choose your platform, then follow the matching setup path.

Open GitHub Releases Install docs

Quick facts

>Start with the current release page.
>Prepare a supported game file.
>Choose your platform below before selecting any release asset.

Before you start

Pick the current release

Use GitHub Releases to choose the current build for your device.

Prepare your own game file

The app needs a supported game file.

Pick your platform

Use the Windows, Steam Deck, Android, iOS, macOS, or Linux page for platform-specific requirements.

Choose your platform

Windows

Best for desktop users who want the shortest setup route.

Package: release asset
Main risk: Missing Visual C++ runtime

Steam Deck

Best for Deck users who need Desktop Mode, Add to Steam, and controller checks.

Package: Linux AppImage
Main risk: AppImage is not executable

Android

Best for Android users comfortable with APK sideloading.

Package: APK
Main risk: Play Protect or vendor warning

iOS and iPhone

Best for users who understand iOS sideloading limits.

Package: IPA
Main risk: Certificate or trust failure

macOS

Best for Mac users choosing between Homebrew and Releases.

Package: Homebrew or release asset
Main risk: Wrong architecture

Linux

Best for desktop Linux users outside the Steam Deck flow.

Package: AppImage
Main risk: AppImage is not executable

Which download should I use?

For every platform, open GitHub Releases and select the asset matching your device and architecture. This site does not hard-code release asset names because they can change.

Steam Deck users should use the Linux/AppImage route, but the Steam Deck guide covers Desktop Mode, Add to Steam, controller, and fullscreen checks that generic desktop Linux users may not need.

Latest release checkpoint

Active

v1.3.1

Released on 2026-05-27. Check the release page before installing so you are not following stale file names.

Check release page

Current release check

Supported game versions

supported

North American NTSC

Official FAQ and README support this GameCube region. Hashes and detailed IDs are not repeated here.

supported

European PAL

Official FAQ and README support this GameCube region. iOS-specific ID details need separate verification.

in development

Other regions

Other regions should be checked against the current FAQ wording.

Common first-run issues

blocking

Invalid disc image

Dusklight cannot use the selected game file.

>Check that the file is a North American NTSC or European PAL GameCube image.
>If the file still fails, compare its region/version and checksum against a trusted dump reference, then select a clean matching file.

blocking

Selected game not supported

The app rejects the selected game after launch.

>Check the supported versions if the file is rejected.
>Use a supported game file.

warning

Play Protect or vendor warning

Android shows a warning while installing the APK.

>Confirm the APK came from GitHub Releases.
>If the package name, version, or signature looks different from the release page, download the APK again.
>If the warning remains, decide whether to continue only after checking the file details.

blocking

AppImage is not executable

The AppImage will not launch.

>Mark the AppImage as executable before running it.
>Steam Deck users should do this in Desktop Mode before adding it to Steam.