TotK Recomp on GitHub: valentderah/totk-pc-recomp
TotK Recomp lives in one place: the GitHub repository valentderah/totk-pc-recomp. The source code, the installers, the documentation and the bug tracker are all there. This page explains what you find in it and which file to take.
github.com/valentderah/totk-pc-recomp Latest release
No game files or keys. The repository and its releases contain only the project’s own code and tools. You need your own copy of the game, dumped from your own console. The project does not explain how to obtain the game files or keys, and neither does this site.
Repository at a glance
| valentderah/totk-pc-recomp | |
|---|---|
| Description | “Static recompilation of The Legend of Zelda: Tears of the Kingdom to native Windows and Linux x86-64, with a Vulkan renderer. Game files not included.” |
| Owner | valentderah |
| Created | October 29, 2026 |
| License | MIT (third-party code listed in THIRD_PARTY_NOTICES.md) |
| Stars / forks (Nov 16) | about 7,478 / about 600 |
| Topics | game, linux, port, recompilation, windows |
| Releases | 14 so far, from 0.1.1 (Oct 29) to 0.4.1 (Nov 15) |
| Issues | about 376 open (with pull requests); read the pinned “Known issues: read before opening an issue” post first |
Which Releases file to download
Version 0.4.1 ships a Windows installer zip and two Linux AppImages (standard plus an experimental PGO build), alongside the two “Source code” archives GitHub adds automatically. Take the installer for your system:
| Release | Windows | Linux / Steam Deck |
|---|---|---|
| 0.4.1 (Nov 15) | TotK-Setup-0.4.1-windows.zip (166,031,600 bytes, about 158 MiB) | TotK-Setup-0.4.1-x86_64.AppImage (230,656,504 bytes, about 220 MiB) + experimental TotK-Setup-0.4.1-x86_64-pgo.AppImage (247,659,000 bytes, about 236 MiB) |
| 0.4.0 (Nov 10) | TotK-Setup-0.4.0-windows.zip (162,476,306 bytes, about 155 MiB) | TotK-Setup-x86_64-0.4.0-linux.AppImage (230,214,136 bytes, about 220 MiB) |
| 0.3.13 (Nov 7) | TotK-Setup-0.3.13-windows.zip (164,418,306 bytes, about 157 MiB) | TotK-Setup-x86_64-0.3.13-linux.AppImage (229,976,568 bytes, about 219 MiB) |
| 0.3.12 (Nov 6) | TotK-Setup-0.3.12-windows.zip (164,322,471 bytes, about 157 MiB) | TotK-Setup-x86_64-0.3.12-linux.AppImage (229,870,072 bytes, about 219 MiB) |
| 0.3.11 (Nov 5) | TotK-Setup-0.3.11-windows.zip (164,515,808 bytes, about 157 MiB) | TotK-Setup-x86_64-0.3.11-linux.AppImage (229,722,616 bytes, about 219 MiB) |
| 0.3.10 (Nov 4) | TotK-Setup-0.3.10-windows.zip | TotK-Setup-x86_64-0.3.10-linux.AppImage |
| 0.3.7 (Nov 3) | TotK-Setup-0.3.7-windows.zip | TotK-Setup-x86_64-0.3.7-linux.AppImage |
| 0.3.4 (Nov 2) | TotK-Setup-0.3.4-windows.zip | TotK-Setup-x86_64.AppImage |
| 0.3.1 (Nov 1) | TotK-Setup-0.3.1-windows.zip | TotK-Setup-0.3.1-x86_64.AppImage |
| 0.2.1, 0.2.8 (Oct 31) | TotK-Setup-0.2.x-windows.zip | TotK-Setup-x86_64.AppImage |
| 0.1.1 – 0.1.9 | TotK-Setup-0.1.x-windows.zip | none (Linux arrived in 0.2.1) |
- The AppImage name changed again in 0.4.1. Releases 0.3.7–0.4.0 used
TotK-Setup-x86_64-<version>-linux.AppImage; in 0.4.1 it isTotK-Setup-0.4.1-x86_64.AppImage(plus the optional profile-guidedTotK-Setup-0.4.1-x86_64-pgo.AppImage). The README still showsTotK-Setup-x86_64.AppImage, so always pick the AppImage from the latest release. - The Windows zip contains
TotK-Setup.exe. It is not code-signed, so SmartScreen warns on first start (More info, then Run anyway). Only do that for the file from the official Releases page. - To update, run the newer installer on your existing install folder: it keeps your game files, saves and
totk.ini, and since 0.3.13 it compares file contents so it rebuilds what changed (#795). - The release notes do not list checksums, but GitHub shows each file’s SHA-256 on the release page (0.4.1 Windows zip
5b1ebd42…3ee8, AppImage5edc6c96…68c1, PGO AppImagecb91aa7d…d1f6). The safest check is still the address:github.com/valentderah/totk-pc-recomp/releases.
Step-by-step setup: how to install; Linux and Deck: Steam Deck & Linux; what changed in each release: changelog.
What is in the repository
| Path | What it holds |
|---|---|
README.md | features, requirements and the short install steps for Windows and Linux |
recomp/ | the recompiler that translates the game’s ARM64 code to C |
runtime/ | the runtime that replaces the Switch system and graphics API, with the Vulkan renderer |
installer/ | the setup that builds the game from your files |
tools/ | build, release and shader translator tools |
totk.ini.example | every setting with its default (see settings) |
docs/ | installer.md, controls.md, mods.md, cheats.md, settings.md (0.3.11), tester-guide.md, building.md, architecture.md and more |
Building from source is for developers: docs/building.md describes the toolchain (Clang from MSYS2 UCRT64 on Windows). Players should use the Releases installer, which brings its own Python and compiler.
Reporting bugs on GitHub
Use the issue tracker and follow CONTRIBUTING.md. Search the pinned known-issues post first, then attach logs/totk.log with your GPU, driver and game version. Since 0.3.10 the log names the port and game versions at the top. Never paste keys into an issue; asking for game files or keys is not allowed.
TotK Recomp vs the UltraTears and SkyboundTOTK repositories
| Repository | Project | What it takes | Releases |
|---|---|---|---|
| valentderah/totk-pc-recomp | TotK Recomp | your NSP/XCI + update 1.1.0, 1.2.1 or 1.4.3 + keys | installer, latest 0.4.1 |
| kuraeow/ultratears | UltraTears | extracted exefs/romfs folders of 1.4.3, reads no keys | launcher, latest 0.4.0 (Nov 11) |
| NotRexed/SkyboundTotk | SkyboundTOTK | extracted ExeFS/RomFS of the 1.0.0 base game | none, build from source |
The three are separate projects by separate people; installers and saves are not interchangeable. TotK Recomp’s README credits other recompilation projects (LAS Recomp, MacNativeGames, nxnative, SavageWindRecomp, Ryujinx and others) for building blocks. Guides to two related Zelda repositories: Revivedx/SavageWindRecomp (Breath of the Wild) and ZeldaWWHDRecomp/ZeldaWWHDRecomp (The Wind Waker HD). Details: TotK Recomp vs UltraTears vs SkyboundTOTK, the UltraTears guide, and Recomp Launcher, a separate launcher that can install TotK Recomp from these Releases.
FAQ
What is the official TotK Recomp GitHub repository?
It is valentderah/totk-pc-recomp at github.com/valentderah/totk-pc-recomp. The project was created there on October 29, 2026, and every release so far has been published on its Releases page.
Which file do I download from TotK Recomp Releases?
On Windows, TotK-Setup-0.4.1-windows.zip; on Linux or Steam Deck, TotK-Setup-0.4.1-x86_64.AppImage (or the experimental PGO build TotK-Setup-0.4.1-x86_64-pgo.AppImage). Ignore the two “Source code” archives GitHub adds to every release: they are the project’s source, not the installer.
Does the TotK Recomp GitHub include the game or keys?
No. The README says no game files are included and that instructions for obtaining them will not be provided. The repository is public and the project keeps every extracted or generated game file out of it.
Is a fork of totk-pc-recomp the same thing?
No. The repository has about 600 forks. Only releases published on valentderah/totk-pc-recomp are official; a fork or a re-upload elsewhere may be outdated or modified.
Is UltraTears the same as TotK Recomp?
No. UltraTears (kuraeow/ultratears) and SkyboundTOTK (NotRexed/SkyboundTotk) are separate projects with their own repositories. See the comparison.