Dusk System Requirements — What's Verified
No official Dusk system requirements yet from TwilitRealm. Here's the verified data — graphics backends, platforms, and the one Steam Deck datapoint.
If you’re trying to find out whether your PC, Mac, phone, or Steam Deck can run Dusk (a.k.a. Dusklight), the honest answer is: TwilitRealm has not published a formal minimum or recommended spec sheet, even at v1.0.1 (2026-05-11).
The only first-party hardware guidance, in the GitHub README and on twilitrealm.dev/faq, is one sentence:
“Dusklight requires a GPU with support for either D3D12, Vulkan, or Metal”
Plus an acknowledged caveat in the same FAQ: TwilitRealm explicitly notes “we are also aware of a number of issues on devices with Adreno GPUs and are working to resolve them” (the Adreno alpha-discard workaround shipped in v1.0.1).
Many other sites have published spec tables. Most of those numbers are guesses based on the GameCube’s age, not benchmarks. We’re going to do the opposite: only state things we can verify, and tell you exactly what we don’t know.
What We Know (Verified)
1. Five platform families are officially supported
From the official README on github.com/TwilitRealm/dusklight:
- Windows (x86_64)
- macOS (Apple Silicon and Intel x86_64 — separate native builds)
- Linux (x86_64 and ARM64 — separate native builds)
- Android (ARM64 APK)
- iOS (ARM64 IPA)
The Steam Deck runs the Linux x86_64 build.
2. Dusklight supports SEVEN graphics backends
Read directly from src/dusk/ui/settings.cpp in the Dusklight source code. The Prelaunch tab → Graphics Backend dropdown lets you choose:
- D3D12 (Direct3D 12, Windows)
- D3D11 (Direct3D 11, older Windows)
- Metal (macOS, iOS)
- Vulkan (Windows, Linux, Android)
- OpenGL (broad fallback)
- OpenGL ES (mobile / older hardware)
- WebGPU (experimental)
This means Dusklight should run on a much wider range of hardware than a Vulkan-only port would. If your machine doesn’t have Vulkan support, you can likely fall back to D3D11, OpenGL, or OpenGL ES.
3. Supported disc image formats
From the same source code (src/dusk/file_select.cpp), Dusklight’s file picker accepts:
iso · gcm · ciso · gcz · nfs · rvz · wbfs · wia · tgc
So you don’t need a raw 1.4 GB ISO — compressed formats like RVZ or CISO work and save disk space.
4. ROM hashes (verified externally)
From the official README:
| Region | Game ID | SHA-1 hash (external check) |
|---|---|---|
| GameCube USA | GZ2E01 | 75edd3ddff41f125d1b4ce1a40378f1b565519e7 |
| GameCube PAL (Europe / Australia) | GZ2P01 | 2601822a488eeb86fb89db16ca8f29c2c953e1ca |
Note: Dusklight internally validates using XXH128 hashes (not SHA-1). The README’s SHA-1 list is for you to verify your own dump using
shasum -a 1(macOS/Linux) orGet-FileHash -Algorithm SHA1(Windows). When Dusklight loads the disc, it computes XXH128 and checks against its built-in table. Both effectively prove your dump is intact.
ROMs that will be recognized but rejected (you’ll see “The selected game is not supported by Dusklight”):
- GZ2J01 — GameCube Japan
- RZDE01 — Wii NA
- RZDP01 — Wii EU/AU
- RZDJ01 — Wii Japan
- RZDK01 — Wii Korea
Wii / Japan / Korea support is on the project’s roadmap.
5. iOS minimum: iOS 16+
From docs/ios-install-altstore.md:
“Enable Developer Mode (iOS 16+)”
Developer Mode is required for sideloading. Pre-iOS 16 devices cannot run Dusklight via the AltStore install path.
6. Build prerequisites (if you build from source)
From docs/building.md:
- CMake 3.25+
- Python 3+
- Windows: Visual Studio 2026 Community + C++ Development workload (Win 11 SDK, CMake Tools, Clang)
- macOS: Xcode 16.4+
- Linux: Ubuntu 24.04, Arch, or Fedora supported
These are not your everyday user requirements — they’re for compiling Dusklight yourself. If you’re downloading the prebuilt binaries, you don’t need any of this.
The One Measured Performance Datapoint
To our knowledge, only one outlet has published a measured Dusklight benchmark in the first 24 hours after launch:
“Even when pushing it to 90 FPS, it will still stick below 11W battery drain.” — Steam Deck HQ, Steam Deck review
That’s it. One sentence. No methodology, no scene tested, no battery-life duration extrapolation. But it does tell us that on a Steam Deck, Dusklight can hit 90 FPS at well under the Deck’s TDP cap, which is consistent with the GameCube being modest hardware by 2026 standards.
The project’s stated framerate target is “unlocked frame rates up to 120 FPS” (per Time Extension’s pre-release coverage), but this is a design goal, not a benchmarked ceiling.
Updated for v1.4.0 (2026-06-16): TwilitRealm overhauled the renderer in v1.4.0, optimizing everything “from game particles to GPU frame submission” and citing up to a 4x improvement on CPU-bottlenecked devices, with framerates described as “much more stable across areas and with heavy effects.” v1.4.0 also fixed a pipeline-cache issue that sometimes caused pop-in. This materially widens the range of hardware that can hold a high framerate — especially lower-end, mobile, and CPU-bound setups. It does not change the absence of an official spec sheet, but it does mean older performance impressions of Dusk likely understate what current builds achieve.
Verified Known Incompatibilities (status as of 2026-05-13)
| Platform | Issue | Status |
|---|---|---|
| Apple Silicon Mac (original dyld crash) | “Dusk quit unexpectedly” on launch | #779, #805 — ✅ Fixed in v1.0.1 |
| Apple Silicon Mac (shader-cache crash) | WebGPU/Metal RmlUi Gradient Pipeline compile failure on launch | #826 — ⏳ Still open |
| Windows non-English username | Silent launch failure (e.g., C:\Users\ミドナ) | #807 — ✅ Fixed in v1.0.1 (Unicode filepaths) |
| Linux AppImage permission error | ”Couldn’t create directory ‘/TwilitRealm’“ | #818 — ✅ Worked around in v1.0.1 (AppImage is now the official Linux distribution) |
| Non-GCN controller w/ WUP-028 adapter | Generates a 4 GiB junk file | #810 — ⏳ Still open |
| Android Snapdragon 8 Elite / Adreno 840 | Stretched textures, vertex explosions, LOD bugs | #750, #801, #846 — ⏳ Some open; per official README, “a number of issues on Adreno GPUs” being worked on |
Recommendation: install v1.0.1, not v1.0.0. That single change fixes most platform-launch failures.
What We Cannot Verify
To be transparent — these things would require either official documentation that doesn’t exist yet, or hands-on benchmarks that nobody has published:
- Minimum supported OS versions (Windows 10 build? macOS version? Android API level?)
- Minimum GPU
- Minimum RAM
- Minimum CPU
- Specific Vulkan version requirement (if you choose the Vulkan backend)
- Steam Deck battery life in hours
- FPS at specific resolution × GPU combos
- Mobile device performance by SoC (Snapdragon, Apple A-series, Tensor, MediaTek)
- Frame-time consistency / 1% lows
- Same-scene Dolphin emulator vs Dusklight benchmarks
- Save file size on disk
- Disk space requirements for high-res texture packs
We will update this page as TwilitRealm publishes official documentation, or as the community produces benchmarks worth citing.
A Reasonable Rule of Thumb
Without official specs, here’s a defensible heuristic — but treat it as opinion, not fact:
Twilight Princess released for GameCube in 2006. The GameCube’s CPU ran at 485 MHz with 24 MB of memory. Dusklight is a native port — it does not emulate that hardware. As long as your machine is from approximately the past 5 years and is one of the supported platforms, Dusklight should run.
This is a rough guideline. The verified known incompatibilities above are real; that’s where you actually need to be careful. And as of v1.4.0’s renderer overhaul (up to 4x on CPU-bottlenecked devices), CPU-bound and lower-end machines have more headroom than earlier builds suggested.
What to Do If Dusklight Won’t Run on Your System
- Try a different graphics backend in Settings → Prelaunch → Graphics Backend. Vulkan and D3D12 are the modern defaults; OpenGL is the broadest fallback.
- Check the GitHub issues page for your specific symptom.
- Check the verified known incompatibilities table above.
- The official Dusklight Discord (discord.gg/dusktp) is run by the Dusklight team and is the fastest place to get troubleshooting help.
Related
- How to install Dusklight on your platform
- Verified known issues at v1.0.0
- Dusklight feature list
Last verified 2026-05-13 against the v1.0.1 release. We’ll update as TwilitRealm publishes a formal spec sheet.