Dusk Light
Back to Dusk Light downloads
NEW

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 dump. The notes below cover Gatekeeper, Metal, file checks, and macOS-specific issues.

Last reviewed: June 16, 2026 against GitHub v1.3.1

Choose the right macOS build

The official v1.3.1 release ships two macOS archives: Dusklight-v1.3.1-macos-arm64.zip for Apple silicon and Dusklight-v1.3.1-macos-x86_64.zip for Intel. The project README says Dusklight requires a GPU path that supports D3D12, Vulkan, or Metal; on macOS that means Metal is the practical requirement. The same README also states that Dusklight does not provide copyrighted game assets and currently supports GameCube USA and EUR dumps. This guide helps you choose the right binary and avoid unsupported game files instead of treating the macOS zip as the whole setup.

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 USA or EUR 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 ship copyrighted assets. The supported game input remains a personal dump of the GameCube USA or EUR release, so Wii files, HD remaster files, and downloaded ROM packs are outside this setup path.

Official file size

For v1.3.1, GitHub lists the macOS Apple silicon zip at 27.6 MB and the Intel zip at 29.3 MB. 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 v1.3.1 file.

Verify Apple silicon zip

shasum -a 256 ./Dusklight-v1.3.1-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-v1.3.1-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 USA or EUR 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.

Windowsv1.3.1 · 35.3 MBmacOSv1.3.1 · 27.6 MBCurrent pageLinuxv1.3.1 · 31.6 MBSteam Deckv1.3.1 · 31.6 MBAndroidv1.3.1 · 50.8 MBiOSv1.3.1 · 26.1 MB

What changed in v1.3.1

Released May 27, 2026

The current macOS guide is based on v1.3.1, the latest GitHub release checked on June 16, 2026. This matters because older Dusk setup pages may still cite pre-rename file names or v1.0-era behavior.

Config saving and loading

The v1.3.1 release notes list fixes around configuration saving and loading. On macOS, that makes it worth updating before diagnosing repeated setting resets or first-launch state problems.

Text input and crash logs

The release also mentions Enter key clearing text inputs and improved crash reporting in log files. If you report a macOS crash, current logs from the v1.3.1 build are more useful than a description alone.

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

Open

A macOS report says certain keyboard bindings, including Return and Shift, did not work when mapped to in-game buttons. Controller setup is therefore worth checking before a long session.

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

Open

A macOS v1.3.0 report describes a crash when exiting Hidden Village and includes a log and video. It is not universal advice, but it is concrete enough to cite when discussing macOS stability evidence.

Open source

Sources used for this macOS guide

Official GitHub repositoryUsed for setup rules, supported GameCube USA and EUR releases, Metal-related hardware requirements, and the copyrighted-asset boundary.Official v1.3.1 releaseUsed for current version status, macOS arm64 and x86_64 file names, file sizes, release timing, and release-note fixes.Issue #826 Metal crashUsed as concrete evidence for macOS launch failures around Metal pipeline creation.Issue #1715 keyboard bindsUsed for macOS-specific input caveats around keyboard binding behavior.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 a recent macOS crash-report example that includes logs and reproduction context.

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.