3.2K ·GitHub
What is this?
It is a static recompilation of The Legend of Zelda: Tears of the Kingdom (originally a Nintendo Switch game) into a native Windows x86-64 application with its own Vulkan renderer. It does not include the game itself; you provide your own legally dumped copy.
It is a static recompilation of The Legend of Zelda: Tears of the Kingdom (originally a Nintendo Switch game) into a native Windows x86-64 application with its own Vulkan renderer. It does not include the game itself; you provide your own legally dumped copy.Is this an emulator, or something different?It is not an emulator. The game's code is statically recompiled into native x86-64 machine code that runs directly on Windows, rather than being interpreted/translated at runtime like an emulator does.
It is not an emulator. The game's code is statically recompiled into native x86-64 machine code that runs directly on Windows, rather than being interpreted/translated at runtime like an emulator does.How do I install and play it?Download the TotK-Setup- -windows.zip from Releases, run TotK-Setup.exe, point it at your own dumped game files, choose a language and install folder, and it builds the game once. After that you launch totk.exe from the install folder.
Download the TotK-Setup- -windows.zip from Releases, run TotK-Setup.exe, point it at your own dumped game files, choose a language and install folder, and it builds the game once. After that you launch totk.exe from the install folder.What hardware and files do I need before trying this?You need Windows 10+, an x86-64 CPU with AVX2, a GPU supporting Vulkan 1.3 with VK_EXT_external_memory_host, about 36 GiB free disk space during setup, and your own legally obtained dump of the base game plus the 1.2.1 or 1.4.3 update.
You need Windows 10+, an x86-64 CPU with AVX2, a GPU supporting Vulkan 1.3 with VK_EXT_external_memory_host, about 36 GiB free disk space during setup, and your own legally obtained dump of the base game plus the 1.2.1 or 1.4.3 update.Does it come with the game, and is it fully stable?No game files are bundled — you must legally dump the game yourself from your own console. The project is also in early development, so visual bugs and crashes are still expected.
No game files are bundled — you must legally dump the game yourself from your own console. The project is also in early development, so visual bugs and crashes are still expected.Does it run on Linux too?Right now it only runs on Windows x86-64. Linux and Steam Deck support, along with mod support and ultrawide aspect ratios, are on the roadmap but not yet available.
Right now it only runs on Windows x86-64. Linux and Steam Deck support, along with mod support and ultrawide aspect ratios, are on the roadmap but not yet available.What kind of performance can I expect compared to the original?It targets 60 fps by default, with an option to go up to 144 fps or your monitor's refresh rate (experimental), plus custom resolutions, supersampling, and AMD FSR 1 upscaling.
It targets 60 fps by default, with an option to go up to 144 fps or your monitor's refresh rate (experimental), plus custom resolutions, supersampling, and AMD FSR 1 upscaling.Can I use mods made for emulator versions of the game?Not yet. Support for unpacking emulator-made mods into a mods folder is listed as a planned feature, not something available today.
Not yet. Support for unpacking emulator-made mods into a mods folder is listed as a planned feature, not something available today.Who actually wrote the code for this project?Most of the code and documentation were written by AI coding agents (Claude Code) directed by the maintainer, who personally plays every build and decides what gets merged.
Most of the code and documentation were written by AI coding agents (Claude Code) directed by the maintainer, who personally plays every build and decides what gets merged.What controls does it support?Keyboard, mouse, and gamepad are all supported, including input remapping, rumble, and gyro controls; full details are in docs/controls.md.
Keyboard, mouse, and gamepad are all supported, including input remapping, rumble, and gyro controls; full details are in docs/controls.md.What are similar projects?bbhost, SkyRecomp, xcx-recomp, SavageWindRecomp, bloodborne_pc, ShadowOfTheColossus-PC, uncharted_pc, pt-pc
bbhost, SkyRecomp, xcx-recomp, SavageWindRecomp, bloodborne_pc, ShadowOfTheColossus-PC, uncharted_pc, pt-pcWhich topics is it in?nintendo-switch, imgui, sdl3, vulkan-api, decompiler, modding, native, installer, gpu-acceleration, game, gaming, reverse-engineering
nintendo-switch, imgui, sdl3, vulkan-api, decompiler, modding, native, installer, gpu-acceleration, game, gaming, reverse-engineering