preserve-emulation/dusk
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Dusk brings a classic adventure to PC and mobile platforms with a variety of fixes and improvements. https://twilitrealm.dev
3,971 commits 18 branches 22 tags 308 MiB
  • C++ 54.5%
  • C 44.3%
  • POV-Ray SDL 0.3%
  • Java 0.3%
  • Pawn 0.3%
  • Other 0.2%
Find a file
Exact
TakaRikka 63b3ce4849 temp fix for speedrun timer controls
2026-05-09 15:16:54 -07:00
.github/workflows Disable macOS x86_64 for now 2026-04-16 23:47:52 -06:00
.vscode add --console to launch.json 2026-04-19 21:43:29 -07:00
assets assets: Remove objdiff screenshot (#691) 2026-05-06 18:38:01 -06:00
ci Fix missing libusb in Linux AppImage (#384) 2026-04-14 17:49:08 -06:00
docs update setup instructions 2026-05-09 07:38:19 -07:00
extern Fix Android backgrounding & re-hide bars after swipe 2026-05-09 15:03:21 -06:00
include Merge pull request #733 from TwilitRealm/fix/e_s1_e_yg 2026-05-09 04:35:25 -07:00
libs Interpolate more things (#699) 2026-05-08 11:50:44 -06:00
platforms Fix Android backgrounding & re-hide bars after swipe 2026-05-09 15:03:21 -06:00
res Fix Syntax Warning (#743) 2026-05-09 14:14:36 -06:00
src temp fix for speedrun timer controls 2026-05-09 15:16:54 -07:00
tools state packs and partial states 2026-04-22 02:44:58 -07:00
.clang-format Start using Rml::PropertyId/Property instead of strings 2026-04-28 00:18:52 -06:00
.clangd Add doxygen comment format to .clangd (#3093) 2026-02-11 00:13:26 -08:00
.flake8 switch to dtk setup (#2203) 2024-10-10 08:29:58 -06:00
.gitattributes switch to dtk setup (#2203) 2024-10-10 08:29:58 -06:00
.gitignore ignore 2026-04-09 04:59:36 -07:00
.gitmodules Change aurora submodule URL to HTTPS 2026-02-28 19:15:40 +01:00
cmake-variants.yaml GCN PAL support (#533) 2026-04-25 15:46:12 -06:00
CMakeLists.txt Fix Android backgrounding & re-hide bars after swipe 2026-05-09 15:03:21 -06:00
CMakePresets.json Disable Sentry in CI builds 2026-05-08 17:12:58 -06:00
files.cmake UI: Add update checks (#715) 2026-05-08 08:52:36 -06:00
flake.lock Add flake.nix to build on NixOS 2026-04-13 22:17:06 -04:00
flake.nix Add flake.nix to build on NixOS 2026-04-13 22:17:06 -04:00
ios.toolchain.cmake CI/CD, CMake improvements, more targets, fix gcc (#258) 2026-04-09 19:22:53 -06:00
LICENSE.md add license (#389) 2023-07-25 17:22:44 -04:00
README.md update setup instructions 2026-05-09 07:38:19 -07:00
version.h.in Integrate Sentry crash reporting for public builds 2026-04-14 00:43:56 -06:00

README.md

Overview

Dusk is a reverse-engineered reimplementation of Twilight Princess.

It aims to be as accurate as possible to the original while also providing new options, enhancements, and tools to customize your experience.

Setup

Important

Dusk does not provide any copyrighted assets. You must provide your own copy of the original game.

1. Verify your dump

First, make sure your dump of the game is clean and supported by Dusk. You can do this by checking the SHA-1 hash of your dump against this list of supported versions:

Version SHA-1 hash
GameCube USA 75edd3ddff41f125d1b4ce1a40378f1b565519e7
GameCube EUR 2601822a488eeb86fb89db16ca8f29c2c953e1ca

*Support for other versions of the game is planned in the future.

2. Download Dusk

3. Setup the game

Windows / macOS / Linux

  • Extract the .zip file
  • Launch Dusk
  • Press Select Disc Image and provide the path to your supported game dump
  • Press Play!

iOS

Android

  • Install the Dusk apk
  • Launch Dusk
  • Press Select Disc Image and provide the path to your supported game dump
  • Press Play!

Building

If you'd like to build Dusk from source, please read the build instructions.

Pull requests are welcomed! Note that we do not accept contributions that are primarily AI-generated and will close your PR if we suspect as much.

Credits

Special thanks to the TP decompilation team, the GC/Wii decompilation community, the Aurora developers, the TP speedrunning community, and all contributors.