TotK Recomp no PC: Windows, Linux e Steam Deck

Guia não oficial · versão 0.4.1 · conferido em 16 de novembro de 2026

O TotK Recomp transforma a sua própria cópia de Zelda: Tears of the Kingdom em um jogo nativo para Windows e Linux. Não é um emulador: o jogo é recompilado no seu PC, roda a 60 fps por padrão e tem menu de ajustes, mods de emulador, DLSS e HDR. Aqui está o essencial em português.

Download oficial no GitHub Como instalar

Advertisement
0.4.1versão mais recente (15 nov 2026)
1.1.0 / 1.2.1 / 1.4.3atualizações do jogo suportadas
60–240limite de fps
36 GBlivres durante a instalação

Nenhum arquivo do jogo incluído. Você precisa do jogo base e da atualização 1.1.0, 1.2.1 ou 1.4.3, extraídos do seu próprio Switch, mais as prod.keys desse console. Os desenvolvedores não explicam como obtê-los, e este site também não. A pasta do jogo pronto é só para uso próprio: não compartilhe.

O que é o TotK Recomp

É um projeto de código aberto (licença MIT) de valentderah. O instalador lê os seus arquivos, traduz o código ARM64 do jogo para C, compila em totk.exe e prepara os shaders antes, para não ter travadinhas de compilação de shader durante o jogo. A compilação leva uns 3 minutos numa CPU de 24 núcleos; a primeira instalação completa demora mais (as notas da 0.1.1 falam em 30 minutos ou mais).

Os desenvolvedores chamam de desenvolvimento inicial: o jogo é jogável no Windows e no Linux, mas bugs visuais e fechamentos ainda são esperados. O desenvolvedor principal testa numa AMD RX 9070. O menu de ajustes e o instalador têm português do Brasil desde a 0.3.1.

Novidades da versão 0.4.1 (15 de novembro de 2026)

As notas avisam que o DLSS e a versão Linux são testados pela comunidade. Fonte: GitHub Releases. Para atualizar, rode o instalador novo na sua pasta de instalação: ele mantém os arquivos do jogo, os saves e o totk.ini.

Advertisement

Requisitos

PeçaRequisitoObservações
SistemaWindows 10 ou mais novo; Linux 6.7+ com glibc 2.34+AppImage para Linux desde a 0.2.1
CPUx86-64 com SSE4.2Desde a 0.3.1. CPUs com AVX2/FMA (Intel Haswell, AMD Ryzen ou mais novas) recebem a build mais rápida
GPUVulkan 1.3 com VK_EXT_external_memory_hostDriver atualizado. As notas da 0.1.1 citam 4 GB de VRAM
RAM16 GBSegundo as notas da 0.1.1
DiscoCerca de 36 GB livres durante a instalação, 20 GB depoisSegundo o README
Mac / Android / ARMNão suportado

Arquivos do jogo necessários

Os três precisam vir do seu próprio console e da sua própria cópia. O instalador confere a atualização por hash, então outras versões são recusadas. Este site não explica como obter nenhum desses arquivos.

Placas de vídeo

Como instalar no Windows

  1. Baixe TotK-Setup-0.4.1-windows.zip (cerca de 164 MB) na página oficial de Releases e descompacte onde quiser.
  2. Abra o TotK-Setup.exe. Como ele não é assinado, o SmartScreen pode avisar: clique em Mais informações e depois em Executar assim mesmo.
  3. Escolha o jogo base, a atualização, as suas prod.keys, o idioma do jogo e uma pasta de instalação. Com uma NVIDIA RTX, deixe marcada a caixa Download NVIDIA DLSS (ligada por padrão desde a 0.3.7). Para texto em chinês ou coreano, dá para indicar também uma pasta de firmware do seu próprio console, da qual o instalador copia as fontes do sistema.
  4. Clique em Start. O instalador confere os arquivos, extrai, traduz e compila o jogo e prepara os shaders. Se for cancelado ou falhar, rode de novo na mesma pasta: ele continua da última etapa concluída.
  5. Abra o totk.exe na pasta de instalação. F1 (ou Menos + Mais no controle) abre os ajustes, F10 o contador de desempenho e F11 a tela cheia sem bordas.

Guia detalhado passo a passo: How to install (em inglês).

Linux e Steam Deck

Desde a 0.2.1 (31 de outubro de 2026) o TotK Recomp também roda nativamente no Linux, com instalador em AppImage e padrões para o Steam Deck.

  1. No Steam Deck, mude para o Modo Desktop.
  2. Baixe TotK-Setup-0.4.1-x86_64.AppImage (cerca de 230 MB) na página oficial de Releases. O README ainda mostra o nome antigo TotK-Setup-x86_64.AppImage; pegue o AppImage da versão mais nova.
  3. Torne o arquivo executável (botão direito → Propriedades → Permissões, ou chmod +x) e abra.
  4. Escolha seus arquivos, idioma e uma pasta de instalação (o cartão SD funciona). O jogo é o arquivo totk nessa pasta. Para o Modo de Jogo, adicione-o ao Steam como jogo não Steam.
AjustePadrão no Steam Deck
fullscreen1
window_size / output_res1280x800 (16:10, com HUD adaptado)
vk_presentfifo (vsync)
fps_limit40

Experimental. Os desenvolvedores chamam esses valores de ponto de partida, não de medições. A documentação ainda marca o Steam Deck como não verificado, e as notas da 0.4.1 dizem que a versão Linux é testada pela comunidade. A 0.3.7 corrigiu paredes e chão faltando nas Profundezas em GPUs AMD (visto no Deck e na RX 570). Requisitos extras: Linux 6.7+, glibc 2.34+ (Ubuntu 22.04, Debian 12, Fedora 35, SteamOS 3). O DLSS no Linux funciona desde a 0.3.7 com a biblioteca NGX do driver NVIDIA e o libnvidia-ngx-dlss.so colocado manualmente ao lado do totk.

Mais detalhes: Steam Deck & Linux (em inglês).

Ajustes importantes

Aperte F1 no jogo ou edite o totk.ini ao lado do totk.exe.

Chave do totk.iniPadrãoO que faz
fps_limit6030 a 240 ou display (taxa do monitor, no máximo 240). Acima de 60 é experimental e precisa de realtime = 1 (padrão).
output_res1920x1080 ou sua telaResolução do jogo (1280x720 a 7680x4320). Tem HUD adaptado para 15 tamanhos em 21:9, 32:9, 16:10 e 3:2; sem layout próprio, desenha 16:9 com barras (0.3.12).
render_scale / upscalergame / fsrEscala da cena 3D (25–400%) e upscaling AMD FSR 1.
dlaa / dlss0 / dlaaNVIDIA DLSS/DLAA só em RTX: dlaa, quality, balanced, performance ou ultra_performance.
hdr01 liga o HDR10 (precisa de “Usar HDR” ligado no Windows).
fov100Campo de visão, 70 a 140 % (só 1.4.3).
mouse_modedirectCâmera direta com mouse no 1.4.3 (0.3.10) e no 1.2.1 (0.3.11); stick volta à emulação de analógico.
vk_recorder0 em AMDEm [performance]: na 0.3.12 teste vk_recorder = 1 em GPUs AMD para ganhar fps; volte para 0 se der tela preta ou VK_ERROR_DEVICE_LOST.
replay_asynconSe o fps cair ou travar, use replay_async = 0.
menu_langidioma do WindowsIdioma do menu de ajustes e do overlay: en, ru, pt-BR ou zh-Hans. Com o Windows em português do Brasil, já abre em pt-BR.

Todos os ajustes: Settings & totk.ini (em inglês).

Mods e cheats

Desde a 0.3.1, o TotK Recomp carrega mods feitos para emuladores e arquivos de cheats do Atmosphère, e desde a 0.3.12 também pacotes de texturas HD sem ajuste manual. Este site não hospeda nem indica links de mods ou cheats: pegue só com os autores e para a sua versão do jogo (1.1.0, 1.2.1 ou 1.4.3).

  1. Abra o menu (F1) e use Open mods folder, ou crie mods ao lado do totk.exe.
  2. Descompacte cada mod na sua própria pasta: mods/<nome>/romfs/.... As estruturas do Ryujinx, do yuzu e do cartão SD do Switch são reconhecidas como estão.
  3. Na aba Mods, ligue, desligue e ordene os mods; se dois mudam o mesmo arquivo, vale o de cima. As mudanças valem no próximo início.
Tipo de modSituação
Mods de RomFS (texturas, modelos, texto, jogabilidade)funciona
Pacotes de texturas HDfunciona desde a 0.3.12 (#673, #858): aumenta o heap sozinho (ou use tex_heap_extra_mb)
Saída combinada do TKMMfunciona (exporte para uma pasta vazia dentro de mods)
Patches ExeFS de código e dados (.ips, .pchtxt) para a sua versãofunciona (dados em main desde a 0.3.12, #835)
Plugins de código (UltraCam e outros mods exlaunch)não funciona
Mods de 60 fps e de resoluçãodesnecessários: já estão nos ajustes

Cheats: coloque um arquivo de cheats do Atmosphère (<build id>.txt) na pasta cheats de um mod e ligue cada cheat na aba Cheats durante o jogo. Cheats que mudam o código precisam de uma recompilação automática (cerca de um minuto e meio num PC rápido), que exige a pasta descompactada do instalador.

Guia completo: Mods & cheats (em inglês).

Correção de erros

Primeiro atualize para a versão mais recente: quase toda versão corrige fechamentos e bugs gráficos.

Fechamento VK_ERROR_DEVICE_LOST ou “write invalid” durante o jogo

Atualize para a 0.3.13 (#788, #802): objetos, pools de memória e registros de textura liberados agora esperam os comandos de GPU em gravação rodarem. Se ainda acontecer, anexe o logs\totk.log numa issue: desde a 0.3.13 ele indica o objeto que tinha o endereço da falha.

Fechamento ao iniciar em igvk64.dll com gráficos Intel

Corrigido na 0.3.13 (#681).

Símbolo indefinido ou totk.exe antigo depois de atualizar

Corrigido na 0.3.13 (#795): o instalador compara o conteúdo dos arquivos em vez das datas. Rode de novo o instalador 0.3.13 na sua pasta.

FPS cai para sempre depois da luneta do Purah Pad ou de jogar muito tempo com pouca VRAM

Corrigido na 0.3.12 (#754): texturas já liberadas ficavam na memória de vídeo até enchê-la. Agora elas são liberadas quando falta VRAM; se ainda cair, ligue F1 > Compress ASTC to BC3 (astc_bc = 1).

Fechamento ao iniciar ou loop de Lua sangrenta com pacote de texturas HD

Corrigido na 0.3.12 (#673, #858): o port lê o arquivo HeapDef do pacote e aumenta o heap de texturas sozinho, inclusive acima de mods de conteúdo como The Second Quest. Se o pacote não tiver HeapDef, defina tex_heap_extra_mb (0 a 4096) em [mods]; com menos de 8 GB de VRAM, ligue Compress ASTC to BC3.

Tela preta ou VK_ERROR_DEVICE_LOST em AMD (vk_recorder)

A 0.3.1 desligou vk_recorder por padrão em AMD para corrigir a tela preta ao iniciar em RDNA 2–4. Na 0.3.12 a thread de gravação foi refeita e as notas convidam a testar [performance] vk_recorder = 1 no totk.ini para ganhar fps em GPUs AMD; se der tela preta ou VK_ERROR_DEVICE_LOST, volte para vk_recorder = 0 e anexe logs\totk.log.

Fechamento com mods quando começa a nevasca forte em Hebra

Corrigido na 0.3.11 (#776): um mod que mudava um arquivo dentro de um pack do jogo sem a própria tabela de tamanhos fazia o jogo fechar ao carregar esse arquivo.

Com fullscreen = 1 o jogo fica em janela

Corrigido na 0.3.11 (#738, #766, #622).

Barras pretas ou resolução diferente depois de atualizar para 0.3.11 ou mais nova

Desde a 0.3.11, em telas que não são 16:9 a resolução que você nunca escolheu segue o formato da tela (use output_res = 1920x1080 para voltar ao tamanho antigo). Desde a 0.3.12 (#809, #814), se uma resolução não tiver layout de HUD próprio, o jogo desenha 16:9 com barras pretas em vez de esticar o HUD.

Queda de FPS ou travadinhas depois de atualizar para 0.3.7 ou mais nova

As notas da versão dizem: coloque replay_async = 0 no totk.ini. Se o jogo fecha ou fica com visual errado onde a 0.3.4 não ficava, teste replay_async = 0, gpl = 0 ou astc_bc = 0 em [performance], um de cada vez.

A imagem treme com DLSS ou DLAA na NVIDIA

Corrigido na 0.3.10 (#612, #701). Atualize para a versão mais recente.

O uso de memória cresce até acabar a memória

Corrigido na 0.3.10 (#670): crescia cerca de 44 MiB por minuto de jogo.

A câmera com mouse ficou diferente no 1.4.3

Desde a 0.3.10 a câmera direta com mouse é o padrão e o mouse_sens tem outra escala: comece em 1. Para voltar ao comportamento antigo, escolha Stick emulation na aba Controls ou use mouse_mode = stick.

Fecha alguns segundos depois de abrir com a exceção 0xc0000409

Corrigido na 0.3.1 (#222, #176, #75). Atualize.

Fecha depois do logo da Nintendo (AMD RX 5000/6000/9000)

Corrigido na 0.2.1. Atualize e apague as linhas antigas de gambiarra que você colocou no totk.ini (gpl, astc, vk_subgroup_pin, memory, ou vk_recorder se der device lost): a build escolhe isso por GPU e, segundo o aviso oficial de problemas conhecidos, astc = cpu agora causa texturas verdes.

Saves somem ou o progresso é perdido

Corrigido na 0.2.8 (#260, #263): quando outro programa (antivírus, pré-visualização do Explorer, sincronização na nuvem) segurava a pasta de saves, o salvamento falhava em silêncio. Atualize.

O som some e não volta

Corrigido na 0.3.4 (#131).

Fecha ao carregar com monitor de 240 Hz

Corrigido na 0.3.1: a física do jogo falha acima de 240 fps, então o limite para em 240.

O instalador diz que o jogo base “não é Tears of the Kingdom”

Provavelmente você escolheu a atualização ou um pacote combinado como jogo base. Escolha o arquivo do jogo base 1.0.0 no primeiro campo.

Um mod não carrega

A aba Mods (F1) marca o mod que o port não consegue usar e diz o motivo: plugins de código como o UltraCam ou patches para outra versão do jogo não funcionam (patches ExeFS que mudam dados de main funcionam desde a 0.3.12, #835).

O Windows SmartScreen bloqueia o TotK-Setup.exe

O instalador não é assinado. Clique em Mais informações e depois em Executar assim mesmo, só com o arquivo da página oficial de Releases.

Android ou drivers Vulkan de celular

Não é suportado: o port precisa de VK_EXT_external_memory_host (#161). macOS também não.

Logs: logs\totk.log na pasta de instalação (a última execução) e totk.1.log a totk.4.log (as quatro anteriores). Antes de abrir um relato no issue tracker oficial, leia o aviso fixado de problemas conhecidos e anexe o totk.log com a sua versão, GPU e driver. Nunca cole as suas chaves num log ou relato.

Lista completa: Troubleshooting (em inglês).

É legal?

O código do projeto é licenciado sob MIT e não contém nada do jogo. Você fornece a sua própria cópia legal, extraída do seu próprio console. Não compartilhe a pasta do jogo pronto (ela contém o jogo) nem baixe arquivos ou chaves de outras pessoas. Isto não é aconselhamento jurídico; mais em Is it legal? (em inglês).

Guias completos (em inglês)

Advertisement

Perguntas frequentes

O TotK Recomp é um emulador?

Não. Um emulador como o Ryujinx imita o Switch enquanto o jogo roda. O TotK Recomp traduz antes o código ARM64 do jogo para C, compila tudo em totk.exe no seu PC e troca o sistema e a API gráfica do Switch por um runtime próprio com Vulkan.

O TotK Recomp vem com o jogo?

Não. O download traz só o instalador e as ferramentas de compilação. Você precisa da sua própria cópia legal do jogo, extraída do seu próprio console: o jogo base mais a atualização 1.1.0, 1.2.1 ou 1.4.3, e as chaves do seu console. O projeto não explica como obter esses arquivos, e este site também não.

Qual é a versão mais recente do TotK Recomp?

A 0.4.1, publicada em 15 de novembro de 2026 no GitHub Releases. Ela corrige fechamentos aleatórios após minutos ou horas de jogo (#1005, #1137, #1145), traz NVIDIA Reflex (#638), calibração do giroscópio (#1197), distância da grama (grass_range), volumes separados de música/efeitos/vozes (#722), escolha do dispositivo de áudio (#1014), reconstrução de cores HDR (#552), correção de halos contra nuvens em AMD (#164, #1203), patches de 60+ fps e ultrawide no 1.1.0 (#1002) e recompilação de cheats em ~4 s (#996). A 0.4.0 (10 de novembro) reduziu o uso de memória em cerca de 1,4 GB (#921) e corrigiu a escalada acima de 60 fps (#35).

Quais versões do jogo são suportadas?

O jogo base com a atualização 1.1.0, 1.2.1 ou 1.4.3. Os saves passam entre 1.2.1 e 1.4.3. Outras atualizações não são suportadas.

O TotK Recomp roda no Steam Deck?

Desde a 0.2.1 existe um AppImage para Linux com padrões para o Steam Deck (1280x800, vsync, 40 fps). A 0.3.7 corrigiu paredes e chão faltando nas Profundezas, vistos no Deck. A documentação ainda marca o Deck como não verificado e as notas dizem que a versão Linux é testada pela comunidade: trate como experimental.

Roda sem AVX2?

Sim, desde a 0.3.1. Basta uma CPU x86-64 com SSE4.2; CPUs com AVX2 recebem uma compilação mais rápida.

Como ativo o DLSS?

Precisa de uma NVIDIA RTX. No Windows o instalador baixa o nvngx_dlss.dll desde a 0.3.7 (caixa Download NVIDIA DLSS). Depois coloque dlaa = 1 e escolha dlss (dlaa, quality, balanced, performance ou ultra_performance) no menu F1 ou no totk.ini.

Mods como o UltraCam funcionam?

Não. Desde a 0.3.1 funcionam mods de RomFS, a saída do TKMM e patches .ips e .pchtxt (de código e, desde a 0.3.12, também de dados), além de pacotes de texturas HD desde a 0.3.12, mas não plugins de código como o UltraCam (subsdk* ou main.npdm no exefs). FPS, resolução e FOV já estão nos ajustes.

O menu tem português?

Sim. Desde a 0.3.1 o menu de ajustes e o instalador estão em português do Brasil. O menu segue o idioma do Windows; para forçar, use menu_lang = pt-BR no totk.ini.

É grátis?

Sim. É um projeto não comercial sob a licença MIT. O único download oficial fica no GitHub Releases de valentderah/totk-pc-recomp.