Dusk Light
Back to Dusk Light downloads
LATEST

Set up Dusk Light on macOS

M-series Macs should use the Apple silicon zip; older Intel Macs should use the Intel x86_64 zip. After downloading, open Dusklight from the extracted app and choose your supported GameCube or Wii dump. The notes below cover Gatekeeper, Metal, file checks, and macOS-specific issues.

Last reviewed: September 19, 2026 against GitHub v2.0.0

Choose the right macOS build

v2.0.0 provides separate Apple silicon and Intel archives. macOS requires Metal. Use your own GameCube or Wii disc dump; all retail editions except Korean Wii are supported. Wii discs still use the GameCube HUD.

Install steps

  1. 01Download the macOS release for your Mac: ARM64 for Apple silicon, x86_64 for Intel. You can also use Homebrew with brew install dusklight.
  2. 02If you downloaded the zip, double-click it to extract Dusklight.app.
  3. 03Move Dusklight.app to Applications or launch it from the extracted folder. If macOS blocks the first launch, open it from Finder's context menu.
  4. 04Open Dusklight, choose Select Disc Image, and pick your supported personal GameCube or Wii (except Korean Wii) dump.

Before you start

Apple silicon vs Intel

M1, M2, M3, and newer Apple silicon machines should start with the macOS ARM64 zip. Intel Macs should use the x86_64 zip. Mixing these builds is the most common avoidable macOS download mistake.

Metal-ready Mac

The official README lists D3D12, Vulkan, or Metal as the graphics baseline. Because macOS uses Metal for this path, older Intel iGPU machines and legacy-patched Macs deserve extra caution before long play sessions.

Your own dump

Dusklight does not include copyrighted game assets. Use your own supported GameCube or Wii dump, excluding Korean Wii. Twilight Princess HD is not supported.

Official file size

For v2.0.0, GitHub lists the macOS Apple silicon zip at 36.6 MiB and the Intel zip at 38.2 MiB. A very different file name or size is a reason to re-check the source before opening it.

Check the macOS archive

The safest macOS install flow is to download from GitHub, record the archive you used, then keep the first launch decision separate from Gatekeeper anxiety. These commands are optional, but they give careful users a repeatable record of the exact v2.0.0 file.

Verify Apple silicon zip

shasum -a 256 ./Dusklight-v2.0.0-macos-arm64.zip

Run this in Terminal from the folder where the Apple silicon zip was downloaded. Compare the result with the digest shown by GitHub release asset metadata if you are auditing the file.

Verify Intel zip

shasum -a 256 ./Dusklight-v2.0.0-macos-x86_64.zip

Use this for Intel Macs. Keeping separate notes for arm64 and x86_64 helps avoid reinstalling the wrong build after a later update.

Inspect Gatekeeper status

spctl --assess --verbose ./Dusklight.app

After extraction, this can help explain why macOS is asking for approval. Do not use it as a reason to trust a file from a mirror; source verification still comes first.

macOS notes

  • Use Apple silicon for M-series Macs and x86_64 for Intel Macs. Do not swap builds just because an app fails once; check logs and issue context first.
  • Gatekeeper approval should happen only after source verification. The expected source is the official GitHub release asset, not a third-party mirror.
  • Metal support is part of the practical hardware requirement. Older Intel iGPU reports should be treated as compatibility evidence, not as a promise that every Mac will work.
  • Keep your supported GameCube or Wii (except Korean Wii) dump outside the app bundle so app updates do not disturb your game file.
  • Dusk Light does not host ROMs, ISOs, disc images, copyrighted textures, or replacement game assets.

Other official builds

Explore same-language install pages

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

Windowsv2.0.0 · 53.5 MiBmacOSv2.0.0 · 36.6 MiBCurrent pageLinuxv2.0.0 · 45.1 MiBSteam Deckv2.0.0 · 45.1 MiBAndroidv2.0.0 · 55.9 MiBiOSv2.0.0 · 35.3 MiB

What changed in v2.0.0

Released September 19, 2026

GitHub marks v2.0.0 as the latest stable release. It provides separate Apple silicon and Intel archives.

macOS support and performance

v1.4.0 added a renderer performance overhaul and fixed macOS 12 support. Use v2.0.0 before diagnosing an old startup or performance report.

Mods, textures, and saves

v2.0.0 adds the mod browser and Save Manager, plus streamed texture replacements and improved caching. Include the Mac model, macOS version, build architecture, and Metal error text if a texture pack or graphics backend fails.

macOS issue tracker notes

Issue #826: Metal launch crash

Open

A macOS crash report describes launch failure around RenderPipelineMTL and Metal pipeline creation. This is a useful warning for older or unusual Mac graphics setups, especially before assuming the zip is corrupt.

Open source

Issue #1715: keyboard binds

Closed upstream

The project closed this keyboard-binding issue on August 4, 2026. It remains a historical report, not a confirmed v2.0.0 regression. If Return or Shift still fails, report the macOS version, keyboard layout, and current Dusklight build.

Open source

Issue #1717: WUP-028 adapter on macOS

Open

A user reported that a Nintendo Wii U GameCube adapter worked in Dolphin but not in the macOS Dusklight build. Treat GameCube adapter setup as something to verify early.

Open source

Issue #1832: Hidden Village crash

Completed in v1.4.0

v1.4.0 fixed the Hidden Village crash after receiving Ilia's Charm. Keep this report as historical context for older builds.

Open source

Sources used for this macOS guide

Official GitHub repositoryUsed for the current setup flow, Metal-related hardware requirements, and the copyrighted-asset boundary.Official v2.0.0 releaseThe v2.0.0 release provides file names, byte counts, SHA-256 digests, release timing, and current feature and fix notes.Issue #826 Metal crashUsed as concrete evidence for macOS launch failures around Metal pipeline creation.Issue #1715 keyboard bindsUsed for the macOS keyboard-binding report and its current closed status.Issue #1717 WUP-028 adapterUsed for macOS GameCube adapter caution before visitors assume a controller path will work exactly like Dolphin.Issue #1832 Hidden Village crashUsed as historical evidence for a crash fixed in v1.4.0.

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.