TotK Recomp no PC: Windows, Linux e Steam Deck
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
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)
- 0.4.1 (15 de novembro): corrige fechamentos aleatórios após minutos ou horas de jogo (#1005, #1137, #1145) e o fechamento com lança carregada acima de 60 fps (#1194); traz NVIDIA Reflex (#638), calibração do giroscópio (#1197), clique no mapa e nos diálogos, roda do mouse nos menus e botão do touchpad DualSense (#482); corrige o halo claro contra nuvens e neblina em AMD (#164, #1203), o brilho néon em HDR (#552) e a cintilação do DLSS/DLAA (#1161–#1184, 1.2.1 #1106); leva os patches de 60+ fps e ultrawide ao 1.1.0 (#1002); adiciona distância da grama (
grass_range), volumes separados de música/efeitos/vozes (#722), escolha do dispositivo de áudio (#1014), recompilação de cheats em ~4 s (#996) e um AppImage PGO experimental para Linux. - 0.4.0 (10 de novembro): cerca de 1,4 GB a menos de memória em sessões longas (#921, 30% menos VRAM no Campo de Hyrule); picos curtos de falta de memória tentam de novo por até 30 s em vez de fechar o jogo (#1031); texturas comprimidas em BC3 por padrão em gráficos integrados (+20% fps em iGPUs Ryzen); o gravador de comandos da GPU (
vk_recorder) vem ligado por padrão também em GPUs AMD (usevk_recorder = 0nototk.inise tiver tela preta ouVK_ERROR_DEVICE_LOST, #1032); corrigida a velocidade de escalada acima de 60 fps (#35) e as portas de engrenagem no 1.2.1 (#330); nova opção de Resolução dinâmica (#916) e botões Xbox/PC em telas 21:9, 32:9, 16:10 e 3:2 (#378). - Menos fechamentos
VK_ERROR_DEVICE_LOSTna 0.3.13 (#788, #802): uma thread podia liberar uma textura que outra ainda usava ao gravar comandos da GPU (“write invalid”, mais na NVIDIA); agora todo objeto liberado, pool de memória e registro de textura espera esses comandos rodarem, o que pesa mais em gráficos integrados (Intel, APUs AMD). Ologs\totk.logpassa a indicar o objeto que tinha o endereço da falha. - Correções: fim do fechamento ao iniciar em
igvk64.dllna Intel (#681); instalar por cima de uma versão antiga compara o conteúdo dos arquivos e recompila o que mudou (#795); a câmera volta à distância normal depois de mirar com o mouse direto; com rótulos Xbox o losango de ação fica igual ao controle Xbox. - Teclado e mouse nos menus (#905, #908): T é uma segunda tecla para Y (organizar o inventário com teclado e mouse), os botões do meio e laterais do mouse mantêm suas funções nos menus, e uma linha
bind_tira aquela tecla dos padrões de outros botões. - Desempenho: texturas são convertidas na GPU em vez da CPU, e a travada ao entrar numa área nova caiu de 145 para cerca de 80 ms no teste do desenvolvedor (fps médio igual); cada draw grava só os estados dinâmicos que mudaram (8,5% menos por quadro numa RTX 4070 Ti na Grande Ilha do Céu); menos barreiras completas de GPU. O log também cita o módulo do driver quando o jogo fecha dentro dele (#285), e as notas seguem convidando a testar
vk_recorder = 1em GPUs AMD. - 0.3.12 (6 de novembro): pacotes de texturas HD sem ajuste manual (#673, #858), patches ExeFS que mudam dados de
main(#835), fim da queda permanente de fps após a luneta com pouca VRAM (#754), 16:9 com barras em resoluções sem HUD próprio (#809, #814), tempo jogado em F1 > Game (#720) e o convite para testar[performance] vk_recorder = 1em AMD (volte para0se der tela preta ouVK_ERROR_DEVICE_LOST). - 0.3.11 (5 de novembro): em telas 21:9, 32:9, 16:10 ou 3:2 a resolução padrão segue o formato do monitor (use
output_res = 1920x1080em GPUs fracas), vídeos 16:9 com barras (#650) e mira do Recall certa em 21:9/32:9 (#685); corrigiu fechamento com mods na nevasca de Hebra (#776), ao escalar Stone Talus no 1.4.3, piscada no menu rápido (#225), tela cheia ao iniciar (#738) e início no Linux em CPUs antigas; câmera direta com mouse no 1.2.1 (#751), mapa com mouse no 1.4.3 (#752), fila de quadros opcional (#625) e instalador nítido em alto DPI (#602). - 0.3.10 (4 de novembro): perfil de execução no Windows para 1.2.1 e 1.4.3 (5–10% menos tempo de CPU por quadro) e menos cópia para a GPU (#698); corrigiu a tremedeira de DLSS/DLAA na NVIDIA (#612, #701), chuva e cachoeiras (#91, #528), fogo na grama (#132) e vazamento de 44 MiB/min (#670); câmera direta com mouse, mouse nos menus e ícones PC no 1.4.3.
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.
Requisitos
| Peça | Requisito | Observações |
|---|---|---|
| Sistema | Windows 10 ou mais novo; Linux 6.7+ com glibc 2.34+ | AppImage para Linux desde a 0.2.1 |
| CPU | x86-64 com SSE4.2 | Desde a 0.3.1. CPUs com AVX2/FMA (Intel Haswell, AMD Ryzen ou mais novas) recebem a build mais rápida |
| GPU | Vulkan 1.3 com VK_EXT_external_memory_host | Driver atualizado. As notas da 0.1.1 citam 4 GB de VRAM |
| RAM | 16 GB | Segundo as notas da 0.1.1 |
| Disco | Cerca de 36 GB livres durante a instalação, 20 GB depois | Segundo o README |
| Mac / Android / ARM | Não suportado |
Arquivos do jogo necessários
- O jogo base Tears of the Kingdom (1.0.0), em XCI ou NSP (desde a 0.3.7 também NSZ e XCZ como estão)
- A atualização 1.1.0, 1.2.1 ou 1.4.3, em NSP
- As
prod.keysdo mesmo console, novas o bastante para essa atualização
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
- NVIDIA RTX: funciona em geral; DLSS e DLAA desde a 0.3.1.
- AMD RX 7000 / 9000: alvo principal do desenvolvimento.
- AMD RX 5000 / 6000: a 0.3.7 eliminou travadas de 0,5–1,2 s (#381).
- AMD RX 470–580: quase tudo corrigido; o problema #67 continua aberto.
- Intel Arc / Iris Xe: roda, com relatos abertos de cintilação e linhas.
- Menos de 5 GB de VRAM: desde a 0.3.7 as texturas ficam comprimidas por padrão (
astc_bc); baixe também a resolução.
Como instalar no Windows
- Baixe
TotK-Setup-0.4.1-windows.zip(cerca de 164 MB) na página oficial de Releases e descompacte onde quiser. - 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. - 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. - 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.
- Abra o
totk.exena 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.
- No Steam Deck, mude para o Modo Desktop.
- 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 antigoTotK-Setup-x86_64.AppImage; pegue o AppImage da versão mais nova. - Torne o arquivo executável (botão direito → Propriedades → Permissões, ou
chmod +x) e abra. - Escolha seus arquivos, idioma e uma pasta de instalação (o cartão SD funciona). O jogo é o arquivo
totknessa pasta. Para o Modo de Jogo, adicione-o ao Steam como jogo não Steam.
| Ajuste | Padrão no Steam Deck |
|---|---|
| fullscreen | 1 |
| window_size / output_res | 1280x800 (16:10, com HUD adaptado) |
| vk_present | fifo (vsync) |
| fps_limit | 40 |
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.ini | Padrão | O que faz |
|---|---|---|
fps_limit | 60 | 30 a 240 ou display (taxa do monitor, no máximo 240). Acima de 60 é experimental e precisa de realtime = 1 (padrão). |
output_res | 1920x1080 ou sua tela | Resoluçã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 / upscaler | game / fsr | Escala da cena 3D (25–400%) e upscaling AMD FSR 1. |
dlaa / dlss | 0 / dlaa | NVIDIA DLSS/DLAA só em RTX: dlaa, quality, balanced, performance ou ultra_performance. |
hdr | 0 | 1 liga o HDR10 (precisa de “Usar HDR” ligado no Windows). |
fov | 100 | Campo de visão, 70 a 140 % (só 1.4.3). |
mouse_mode | direct | Câ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_recorder | 0 em AMD | Em [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_async | on | Se o fps cair ou travar, use replay_async = 0. |
menu_lang | idioma do Windows | Idioma 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).
- Abra o menu (F1) e use Open mods folder, ou crie
modsao lado dototk.exe. - 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. - 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 mod | Situação |
|---|---|
| Mods de RomFS (texturas, modelos, texto, jogabilidade) | funciona |
| Pacotes de texturas HD | funciona desde a 0.3.12 (#673, #858): aumenta o heap sozinho (ou use tex_heap_extra_mb) |
| Saída combinada do TKMM | funciona (exporte para uma pasta vazia dentro de mods) |
Patches ExeFS de código e dados (.ips, .pchtxt) para a sua versão | funciona (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ção | desnecessá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)
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.