Find your guide

Independent port guide.

Installation Guide · TotK Recomp

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.

bash
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.

  1. Open Steam while still in Desktop Mode.
  2. Choose Games → Add a Non-Steam Game to My Library.
  3. Click Browse, open your completed install folder and select totk.
  4. Click Add Selected Programs, use Return to Gaming Mode on the desktop, and launch the new shortcut from your library.
Alternative route

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

  1. Choose its Windows package or native Linux AppImage on Download.
  2. Open UltraTears Launcher.exe on Windows; on Linux allow execution in file Properties and open the AppImage.
  3. Select the parent containing your own plain exefs/ code folder and romfs/ game-data folder, then click Prepare the game.
  4. Click Play after preparation. On Deck, add the prepared game-folder AppImage to Steam with --play in launch options to start directly in Gaming Mode.

Weeping of the Empire: game 1.0.0

  1. Get its Windows Setup from Download.
  2. 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.
  3. Press Install, with internet available for Setup’s tools. If it stops, press Install again to resume.
  4. Open the desktop shortcut or TotK Launcher.exe when 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

Use totk.exe on Windows or totk on Linux for TotK Recomp. F1 opens its in-game settings; use Controls for remapping and Settings for game text.

Your game folder

The install folder keeps the game, local progress and settings together.

  • <install>/
    • totk.exe or totk
    • exefs/
    • 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.

  1. 1
    Recheck the base and update inputs against Game Files.
  2. 2
    Reopen Setup on the same install folder; completed steps are reused.
  3. 3
    Allow 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

  1. 1
    Keep profile/, totk.ini and the installed game folder to preserve progress, preferences and game data.
  2. 2
    Keep the original Setup folder too when using automatic code-mod rebuilds; the game opens that setup path when it needs new code.