TwilitRealm/dusklightPublic

What is dusklight?

A reverse-engineered reimplementation of Twilight Princess focusing on high accuracy and modern enhancements.

What does dusklight do?

Dusklight is a reverse-engineered reimplementation of the classic game Twilight Princess. It aims to achieve exact accuracy to the original engine while providing a modern framework for enhancements and tooling. The project supports modern graphics APIs including D3D12, Vulkan 1.1+, and Metal, effectively modernizing the game's rendering pipeline. By requiring users to supply their own legally dumped game assets, it operates cleanly within legal boundaries while opening the door for extensive customization. It serves as both a playable preservation effort and a deep dive into the architecture of GameCube era software.

Who is dusklight for?

Dusklight is designed for retro gaming enthusiasts, software preservationists, and reverse engineers interested in modernizing classic GameCube titles. It requires users to be comfortable dumping their own game assets and navigating basic compilation or installation steps.

How do I get started with dusklight?

Follow the installation guide at twilitrealm.dev/install/

How popular is dusklight on GitHub?

TwilitRealm/dusklight has 5,631 stars and 418 forks on GitHub, and gained 96 stars in the last 7 days.

What license does dusklight use?

TwilitRealm/dusklight is released under the CC0-1.0 license.

• Oct 4, 2026Previously tracked as TwilitRealm/dusk; its 1 daily snapshot and 1 trending appearance were merged into this profile. Stars: 4,976 on 2026-07-28 under the old name, 5,631 on 2026-10-04 (+655).

• Very active

  2,853 commits in 52 weeks

• Community-driven

  ~118 contributors

• Continuous integration

  Automated checks passing

Dusklight is a reverse-engineered reimplementation of the classic game Twilight Princess. It aims to achieve exact accuracy to the original engine while providing a modern framework for enhancements and tooling. The project supports modern graphics APIs including D3D12, Vulkan 1.1+, and Metal, effectively modernizing the game's rendering pipeline. By requiring users to supply their own legally dumped game assets, it operates cleanly within legal boundaries while opening the door for extensive customization. It serves as both a playable preservation effort and a deep dive into the architecture of GameCube era software.

Dusklight is designed for retro gaming enthusiasts, software preservationists, and reverse engineers interested in modernizing classic GameCube titles. It requires users to be comfortable dumping their own game assets and navigating basic compilation or installation steps.

• High accuracy emulation: Reconstructs the exact logic and behavior of the original Twilight Princess engine.
• Modern graphics backends: Supports D3D12, Vulkan, and Metal for improved rendering performance.
• Asset decoupling: Requires users to provide their own `.rvz` or `.iso` files to ensure strict legal compliance.
• Customization tools: Provides new options and a modern framework to tweak and enhance the gameplay experience.
• Cross-platform compilation: Can be built from source across various modern desktop operating systems.

Getting started: Follow the installation guide at twilitrealm.dev/install/

1. v2.0.3v2.0.3Sep 30, 202617.1K downloads

   **What's new:** * **Added:** New InterpService: Provides interpolation for custom model rendering. ([#2636](https://github.com/TwilitRealm/dusklight/pull/2636)) * **Added:** GfxService v1.4: Provides backing textures for resolved framebuffers. ([#2643](https://github.com/TwilitRealm/dusklight/pull/2643), [Aurora #260](https://github.com/encounter/aurora/pull/260)) * **Fixed:** Vulkan startup crash on Android devices with Adreno GPUs, including the Galaxy S23 and Odin 2. ([Aurora `bded88e95d`](https://github.com/encounter/aurora/commit/bded88e95d5a1a7c8b2d747843cb8cde17b39838), [#2563](https://github.com/TwilitRealm/dusklight/issues/2563)) * **Fixed:** HTTPS requests failing in Linux AppImage builds because system CA certificates weren't found. ([Borealis `4ac5e7052a`](https://github.com/encounter/borealis/commit/4ac5e7052a8c49a122f8d57f626b5c75c5ca6968)) * **Fixed:** WebSocket service being unavailable in Linux AppImage builds. ([`40457c6adb`](https://github.com/TwilitRealm/dusklight/commit/40457c6adb381928e4b5fef6ed459ed291edd5e2), [Borealis `4ac5e7052a`](https://github.com/encounter/borealis/commit/4ac5e7052a8c49a122f8d57f626b5c75c5ca6968)) * **Fixed:** False memory card

2. v2.0.2v2.0.2Sep 25, 202656.3K downloads

   **What's new:** * **Added:** Save Manager can now import saves between different regions, and between GC/Wii. ([#2529](https://github.com/TwilitRealm/dusklight/pull/2529), [`97ca92a056`](https://github.com/TwilitRealm/dusklight/commit/97ca92a056d1499d4183e78f9c9e74f863e1ef2f)) * **Added:** Speedrun Mode now displays enabled mods. ([`7b917f20d1`](https://github.com/TwilitRealm/dusklight/commit/7b917f20d19acaace0f0b9421d5b5115328aa9ba)) * **Fixed:** Mouse buttons not working for Custom Action Bindings, such as First Person. ([`3a1b863dc6`](https://github.com/TwilitRealm/dusklight/commit/3a1b863dc6dc33f535a50cf183d670faed5e4aac), [#2525](https://github.com/TwilitRealm/dusklight/issues/2525)) * **Fixed:** File selection not working on some sideloaded iOS installations. ([Borealis `355186f3c9`](https://github.com/encounter/borealis/commit/355186f3c9954ae3d65fc23d3e71eaee7e38bd5f), [#2601](https://github.com/TwilitRealm/dusklight/issues/2601)) * **Fixed:** Startup crash on Macs with AMD GPUs. ([Aurora `08122911e8`](https://github.com/encounter/aurora/commit/08122911e8621acb7ded6563813b264bec1494b5), [#826](https://github.com/TwilitRealm/dusklight/issues/826)) * **Fixed:** Music c

3. v2.0.1v2.0.1Sep 20, 202674.5K downloads

   Thank you all for the incredible response to our v2 release! 24 hours later, we already have **18 mods** on our [mod site](https://twilitrealm.dev/mods/), and that number is growing steadily. As with every big release, there's some bugs that slip through the cracks, and we've done our best to knock them out quick. Enjoy! **What's new:** * **Added:** Option to change a save's region when importing `.gci` or `.dusksave` files in Save Manager. ([`422d7bb1b6`](https://github.com/TwilitRealm/dusklight/commit/422d7bb1b6c8d973cccf8b3d0b226a57ac3cc8c7)) * **Fixed:** Restored "Show Shader Compilation" option in Interface settings. ([#2504](https://github.com/TwilitRealm/dusklight/pull/2504), [#2474](https://github.com/TwilitRealm/dusklight/issues/2474)) * **Fixed:** Existing saves could be overwritten with empty slots after a load failure with "Instant Saves" enabled. ([#2510](https://github.com/TwilitRealm/dusklight/pull/2510)) * **Fixed:** Memory card errors caused by duplicate `.gci` backups in the save folder. ([#2510](https://github.com/TwilitRealm/dusklight/pull/2510), [Aurora #254](https://github.com/encounter/aurora/pull/254)) * Now only `.gci` with an exact name match a

4. v2.0.0v2.0.0Sep 19, 202635.7K downloads

   Dusklight 2.0 is here! This update brings **mod support**, **an in-game mod browser**, and **our own built-in randomizer**, alongside more polish, performance improvements, and ways to play. Thank you to everyone who helped make it happen! ## Mods and built-in mods - **Added:** Mod support! Install gameplay mods, asset replacements, and texture packs as `.dusk` bundles, and manage them from the Mods menu. (Modders: check out our [modding documentation](https://github.com/TwilitRealm/dusklight/blob/main/docs/modding.md)!) - **Added:** An in-game mod browser: search for mods, view information and screenshots, and download and install without leaving Dusklight. - **Added:** Mod update checks, release notes, and a quick way to update all mods. - **Added:** Drag and drop `.dusk` mods onto the Dusklight window to install them. - **Added:** Enable, disable, and reload mods in-game, with dependency handling and per-mod settings and logs. - **Added:** Built-in Dusklight Randomizer, our own randomizer with seed generation, settings presets, shareable permalinks, and more. - Customize which items are shuffled, including shop items, NPC gifts, Golden Bugs, Poe Souls, Hidden

5. v1.4.1v1.4.1Jun 16, 2026320.7K downloads

   **What's new:** * **Added:** Support Clawshot hanging & Hawkeye with touch controls * **Added:** Configure Android Surface.setFrameRate; improves performance on some devices * **Fixed:** Texture replacement regressions in v1.4.0 (load ordering & missing UI textures) * **Fixed:** Performance regression on some GPUs (AMD on Windows in particular) * **Fixed:** Keyboard focus issues on Android and iOS * **Fixed:** Lock 4:3 aspect issue on PowerVR GPUs * **Fixed:** Hidden Dusklight menu still receiving inputs in some circumstances * **Fixed:** GPU backend fallback regression **Full Changelog**: https://github.com/TwilitRealm/dusklight/compare/v1.4.0...v1.4.1

• tensorflow/tensorflow

  An Open Source Machine Learning Framework for Everyone

  200.7K stars · C++

• ggml-org/llama.cpp

  LLM inference in C/C++

  130.3K stars · C++

• ocornut/imgui

  Dear ImGui: Bloat-free Graphical User interface for C++ with minimal dependencies

  76.5K stars · C++

• protocolbuffers/protobuf

  Protocol Buffers - Google's data interchange format

  72.1K stars · C++

• LadybirdBrowser/ladybird

  Truly independent web browser

  66.4K stars · C++

• grpc/grpc

  C++ based gRPC (C++, Python, Ruby, Objective-C, PHP, C#)

  45.4K stars · C++