How to Install Tears of the Kingdom on PC
Use TotK Recomp’s Setup to turn your own Switch files into a PC game: choose Windows or Linux / Steam Deck, select your files and let preparation finish. You can stop Setup and reopen it on the same destination to continue from its last completed stage.
On this page
Before You Start
Setup builds the game from your files; you can follow the interface without writing code. The Windows package includes Python, the compiler and the required build tools.
- Get the Windows ZIP or Linux AppImage, a Linux application in one file, from Download.
- Prepare your own base game as an XCI/NSP game archive, an update NSP for 1.1.0, 1.2.1 or 1.4.3, and console keys, the file that opens those encrypted archives; check Game Files.
- Allow about 36 GiB for preparation and use an x86-64 processor with SSE4.2 instructions and Vulkan 1.3, the graphics interface, supporting
VK_EXT_external_memory_host; System Requirements explains these checks.
Linux also needs kernel 6.7+ and glibc 2.34+, a core Linux system library. In a terminal, including Konsole in Deck Desktop Mode, run uname -r for the running kernel and ldd --version for glibc on the first line; compare those numbers with 6.7 and 2.34.
Install on Windows
1 Download and extract the package
Download TotK-Setup-0.3.4-windows.zip and extract the ZIP to keep its setup tools together. Open TotK-Setup.exe from the extracted folder. This is the installer; the completed game has its own executable in the destination you choose.
2 Select your inputs and destination
Select the base game XCI or NSP, the supported update NSP and your own console-key file, prod.keys. Choose the game language and an install folder with enough free space. The input files and destination are separate selections; Setup extracts the data into the destination.
For Chinese, Traditional Chinese or Korean text, provide your own system-font input using Setup’s optional firmware-folder field. Check those inputs on Game Files.
3 Start the local build
Press Start. Setup checks the inputs, extracts the game, translates the executable code, compiles it for your processor and prepares graphics programs called shaders. SSE4.2 is the baseline CPU instruction set; extra AVX2/FMA instructions enable the faster build automatically.
4 Wait for preparation to finish
Let the current stage finish before opening the game. The three-minute example covers code compilation on one 24-core CPU; slower processors need a larger time allowance, and the other stages add time. Setup records completed steps so an interrupted or failed preparation can continue in the same folder.
If the graphics driver crashes during shader preparation, Setup retries while leaving out the affected variants and finishes with a warning. Use If Installation Gets Stuck for the next checks.
5 Start the installed game
Open totk.exe inside the completed install folder. The game opens its settings with F1; use After Installing to check language and controls.
Install on Linux
Use the Linux package on an x86-64 Linux PC or Steam Deck. On Deck, open STEAM → Power → Switch to Desktop; STEAM + X shows the keyboard while Steam is running. Have your own exported game, update and keys ready before starting.
The Deck profile starts at a 40 FPS cap, 1280×800 and VSync; these are starting settings for the display and frame limit.
1 Download the AppImage
Download TotK-Setup-x86_64.AppImage in Desktop Mode.
To copy files from your PC, put your already exported game files on a USB drive, connect it to Deck through USB-C or a hub, then open that drive in Dolphin, the file manager, and copy/paste the files into a folder in Home; Valve’s USB guide and KDE’s copy/paste controls cover those operations.
2 Make it executable and open it
On Deck, open the AppImage’s download folder in Dolphin and choose Open Terminal from Dolphin’s menu (Tools → Open Terminal if the menubar is shown); this opens Konsole, the command window, in that folder. With a keyboard, Shift+F4 opens the same window. On another Linux desktop, open a terminal in the download folder and run the command to allow this file to start.
chmod +x TotK-Setup-x86_64.AppImage
Open the executable AppImage to start Setup. Check the Linux kernel and glibc requirements if the application fails to open.
3 Select your files and destination
Choose your own base game, supported update, keys, game language and install folder, then press Start. Setup puts its temporary work in .setup-temp inside the selected destination, including when that destination is on another drive.
4 Wait and launch
Let the extraction, code build and graphics preparation finish. Start totk from the completed folder. If preparation stopped, reopen Setup against the same destination to resume completed steps.
5 Add the Deck game to Steam
Follow Steam’s non-Steam shortcut instructions, choosing the installed game program rather than Setup.
- Open Steam while still in Desktop Mode.
- Choose Games → Add a Non-Steam Game to My Library.
- Click Browse, open your completed install folder and select
totk. - Click Add Selected Programs, use Return to Gaming Mode on the desktop, and launch the new shortcut from your library.
Using UltraTears or Weeping of the Empire Instead?
Choose the route matching the files you already have: extracted 1.4.3 folders for UltraTears, or game 1.0.0 for Weeping of the Empire.
UltraTears: prepared 1.4.3 folders
- Choose its Windows package or native Linux AppImage on Download.
- Open
UltraTears Launcher.exeon Windows; on Linux allow execution in file Properties and open the AppImage. - Select the parent containing your own plain
exefs/code folder andromfs/game-data folder, then click Prepare the game. - Click Play after preparation. On Deck, add the prepared game-folder AppImage to Steam with
--playin launch options to start directly in Gaming Mode.
Weeping of the Empire: game 1.0.0
- Get its Windows Setup from Download.
- Select your own 1.0.0 XCI/NSP and keys, then an NTFS destination with about 15 GB free, or 30 GB if Setup copies the game data.
- Press Install, with internet available for Setup’s tools. If it stops, press Install again to resume.
- Open the desktop shortcut or
TotK Launcher.exewhen preparation finishes. Keep the original game-data location available; Setup normally reads it in place, or copies it for removable sources and Copy the game files.
After Installing
Launch and configuration
Your game folder
The install folder keeps the game, local progress and settings together.
<install>/totk.exe or totkexefs/romfs/profile/logs/totk.ini
Linux temporary work and the default mesa-cache graphics cache also stay with the installed game.
First checks
- Open F1 and check the frame-rate limit. The desktop default is a 60 FPS cap.
- Check that the selected game text displays correctly.
- Check the controller layout and keyboard bindings.
Back up local progress and use Updates when replacing the program.
If Installation Gets Stuck
Keep the selected destination and use the recorded preparation state to resume. After a code-generation MemoryError, current Setup retries with fewer workers; let that retry finish. Linux setup needs a graphical desktop and stops at Check when no display is available.
- 1Recheck the base and update inputs against Game Files.
- 2Reopen Setup on the same install folder; completed steps are reused.
- 3Allow the shader retry to finish after a driver crash and read its warning about skipped variants.
For a game-start failure after installation, keep the failing run’s logs/totk.log and use the project feedback tracker.
For continuing crashes or graphics faults, match the symptom on Troubleshooting.
Keep the Files Needed for Rebuilds
- 1Keep
profile/,totk.iniand the installed game folder to preserve progress, preferences and game data. - 2Keep the original Setup folder too when using automatic code-mod rebuilds; the game opens that setup path when it needs new code.
Sources
Checked November 3, 2026.
- TotK Recomp project github.com
- TotK Recomp v0.3.4 release github.com
- Project feedback github.com
- TotK Recomp installer instructions github.com
- TotK Recomp controls and menus github.com
Zelda PC Guide