TotK Recomp PC 가이드: 윈도우·리눅스·스팀덱

비공식 가이드 · 버전 0.4.1 · 2026년 11월 16일 확인

TotK Recomp는 본인이 가진 젤다의 전설 티어스 오브 더 킹덤을 윈도우·리눅스용 네이티브 게임으로 바꿔 줍니다. 에뮬레이터가 아니라 PC에서 게임을 재컴파일하는 방식이며, 기본 60fps에 설정 메뉴, 에뮬레이터용 모드, DLSS, HDR을 지원합니다. 핵심만 한국어로 정리했습니다.

GitHub 공식 다운로드 설치 방법

Advertisement
0.4.1최신 버전 (2026-11-15)
1.1.0 / 1.2.1 / 1.4.3지원 게임 업데이트
60–240프레임 제한 범위
36 GB설치 중 필요한 여유 공간

게임 파일은 포함되어 있지 않습니다. 본인 스위치에서 덤프한 기본 게임과 1.1.0, 1.2.1 또는 1.4.3 업데이트, 그리고 그 콘솔의 prod.keys가 필요합니다. 개발자는 구하는 방법을 설명하지 않으며 이 사이트도 설명하지 않습니다. 완성된 게임 폴더는 본인만 사용하고 공유하지 마세요.

TotK Recomp란

valentderah가 만든 오픈 소스 프로젝트(MIT 라이선스)입니다. 설치 프로그램이 게임 파일을 읽어 ARM64 코드를 C로 변환하고 totk.exe로 컴파일하며, 셰이더를 미리 준비해 플레이 중 셰이더 컴파일 끊김이 생기지 않게 합니다. 컴파일은 24코어 CPU에서 약 3분이지만 첫 설치 전체는 더 오래 걸립니다(0.1.1 노트 기준 30분 이상).

개발자는 아직 초기 개발 단계라고 밝힙니다. 윈도우와 리눅스에서 플레이할 수 있지만 그래픽 버그와 튕김이 아직 있습니다. 주 개발자는 AMD RX 9070에서 테스트합니다.

0.4.1 변경 사항 (2026년 11월 15일)

릴리스 노트는 DLSS와 리눅스 빌드를 커뮤니티가 테스트한다고 밝힙니다. 출처: GitHub Releases. 업데이트는 새 설치 프로그램을 기존 설치 폴더에 실행하면 되며, 게임 파일·세이브·totk.ini는 유지됩니다.

Advertisement

PC 요구 사양

항목요구 사양비고
OSWindows 10 이상; Linux 6.7 이상 + glibc 2.34 이상리눅스 AppImage는 0.2.1부터
CPUSSE4.2 지원 x86-640.3.1부터. AVX2/FMA CPU(Intel Haswell, AMD Ryzen 이후)는 더 빠른 빌드
GPUVulkan 1.3 + VK_EXT_external_memory_host최신 드라이버. 0.1.1 노트 기준 VRAM 4 GB
RAM16 GB0.1.1 릴리스 노트 기준
디스크설치 중 약 36 GB, 설치 후 20 GBREADME 기준
Mac / 안드로이드 / ARM미지원

필요한 게임 파일

세 가지 모두 본인 콘솔과 본인 사본에서 나온 것이어야 합니다. 설치 프로그램은 업데이트를 해시로 확인하므로 다른 버전은 거부됩니다. 이 사이트는 이 파일들을 구하는 방법을 설명하지 않습니다.

그래픽카드별 상황

윈도우 설치 방법

  1. 공식 Releases 페이지에서 TotK-Setup-0.4.1-windows.zip(약 164 MB)를 받아 원하는 곳에 압축을 풉니다.
  2. TotK-Setup.exe를 실행합니다. 코드 서명이 없어 SmartScreen 경고가 뜨면 추가 정보 → 실행을 누르세요.
  3. 기본 게임, 업데이트, 본인 prod.keys, 게임 언어, 설치 폴더를 고릅니다. NVIDIA RTX라면 Download NVIDIA DLSS를 체크된 상태로 두세요(0.3.7부터 기본 켜짐). 한국어 게임 텍스트를 쓰려면 본인 콘솔의 펌웨어 폴더를 추가로 지정할 수 있습니다. 설치 프로그램이 거기서 스위치 시스템 폰트를 복사합니다.
  4. Start를 누릅니다. 파일 확인, 추출, 코드 변환·컴파일, 셰이더 준비 순으로 진행되며, 취소되거나 실패하면 같은 폴더에 다시 실행해 마지막 완료 단계부터 이어 갑니다.
  5. 설치 폴더의 totk.exe를 실행합니다. F1(패드는 − + 동시)은 설정, F10은 성능 오버레이, F11은 테두리 없는 전체 화면입니다.

단계별 자세한 설명: How to install (영어).

리눅스와 스팀덱

0.2.1(2026년 10월 31일)부터 TotK Recomp는 리눅스에서도 네이티브로 실행되며, AppImage 설치 프로그램과 스팀덱 기본 설정을 제공합니다.

  1. 스팀덱에서는 데스크톱 모드로 전환합니다.
  2. 공식 Releases 페이지에서 TotK-Setup-0.4.1-x86_64.AppImage(약 230 MB)를 받습니다. README에는 아직 예전 이름 TotK-Setup-x86_64.AppImage가 적혀 있으니 최신 릴리스의 AppImage를 받으세요.
  3. 실행 권한을 주고(우클릭 → 속성 → 권한, 또는 chmod +x) 실행합니다.
  4. 게임 파일, 언어, 설치 폴더(SD 카드 가능)를 고릅니다. 게임은 그 폴더의 totk 파일입니다. 게임 모드에서 쓰려면 Steam에 비 Steam 게임으로 추가하세요.
설정스팀덱 기본값
fullscreen1
window_size / output_res1280x800 (16:10, 전용 HUD 배치)
vk_presentfifo (수직 동기화)
fps_limit40

실험적입니다. 개발자는 이 값들을 측정값이 아닌 출발점이라고 설명합니다. 문서는 스팀덱 자체를 아직 검증되지 않음으로 표시하고, 0.4.1 노트는 리눅스 빌드를 커뮤니티가 테스트한다고 밝힙니다. 0.3.7에서 AMD GPU(스팀덱, RX 570)의 지하 벽·바닥 누락이 고쳐졌습니다. 추가 요구: Linux 6.7 이상, glibc 2.34 이상(Ubuntu 22.04, Debian 12, Fedora 35, SteamOS 3). 리눅스 DLSS는 0.3.7부터 NVIDIA 드라이버의 NGX 라이브러리와 직접 totk 옆에 둔 libnvidia-ngx-dlss.so로 동작합니다.

자세한 내용: Steam Deck & Linux (영어).

주요 설정

게임에서 F1을 누르거나 totk.exe 옆의 totk.ini를 수정합니다.

totk.ini 키기본값설명
fps_limit6030–240 또는 display(모니터 주사율, 최대 240). 60 초과는 실험적이며 realtime = 1(기본값)이 필요합니다.
output_res1920x1080 또는 화면 비율게임 해상도(1280x720–7680x4320). 21:9, 32:9, 16:10, 3:2 총 15개 크기에 전용 HUD 배치가 있으며, 없는 해상도는 16:9 여백으로 표시됩니다(0.3.12).
render_scale / upscalergame / fsr3D 장면 배율(25–400%)과 AMD FSR 1 업스케일.
dlaa / dlss0 / dlaaRTX 전용 NVIDIA DLSS/DLAA: dlaa, quality, balanced, performance, ultra_performance.
hdr01이면 HDR10 출력(윈도우의 “HDR 사용” 필요).
fov100시야각 70–140%(1.4.3 전용).
mouse_modedirect1.4.3(0.3.10)·1.2.1(0.3.11) 직접 마우스 카메라. stick은 예전 스틱 에뮬레이션.
vk_recorderAMD 기본 0[performance] 아래: 0.3.12에서 AMD GPU는 vk_recorder = 1로 프레임 향상을 시험할 수 있으며, 검은 화면이나 VK_ERROR_DEVICE_LOST가 나면 0으로 되돌리세요.
replay_asyncon프레임이 떨어지거나 끊기면 replay_async = 0.
astc_bcauto압축 텍스처. VRAM 5 GB 미만에서 기본 켜짐(HD 텍스처 팩 사용 시 8 GB 미만에서도 권장).

전체 설정: Settings & totk.ini (영어).

모드와 치트

0.3.1부터 에뮬레이터용 모드와 Atmosphère 치트 파일을 불러오며, 0.3.12부터는 HD 텍스처 팩도 별도 설정 없이 작동합니다. 이 사이트는 모드·치트 파일을 호스팅하거나 링크하지 않습니다. 제작자에게서, 본인 게임 버전(1.1.0, 1.2.1, 1.4.3)에 맞는 것을 받으세요.

  1. 메뉴(F1)에서 Open mods folder를 누르거나 totk.exe 옆에 mods 폴더를 만듭니다.
  2. 모드마다 폴더를 따로 만들어 풉니다: mods/<이름>/romfs/.... Ryujinx, yuzu, 스위치 SD 카드 구조도 그대로 인식합니다.
  3. Mods 탭에서 켜고 끄고 순서를 정합니다. 두 모드가 같은 파일을 바꾸면 위쪽이 이깁니다. 변경은 다음 실행부터 적용됩니다.
모드 종류상태
RomFS 모드(텍스처, 모델, 텍스트, 게임플레이)동작
HD 텍스처 팩동작 (0.3.12부터 #673, #858: HeapDef 자동 반영 또는 tex_heap_extra_mb)
TKMM 병합 결과동작 (mods 안의 빈 폴더로 내보내기)
본인 버전용 ExeFS 코드·데이터 패치(.ips, .pchtxt)동작 (main 데이터 패치는 0.3.12부터, #835)
코드 플러그인(UltraCam 등 exlaunch 모드)동작 안 함
60fps·해상도 모드불필요: 설정에 내장

치트: Atmosphère 치트 파일(<build id>.txt)을 모드의 cheats 폴더에 넣고, 플레이 중 Cheats 탭에서 하나씩 켭니다. 코드를 바꾸는 치트는 자동 재빌드가 필요하며(빠른 PC에서 약 1분 30초), 설치에 쓴 압축 해제 폴더가 남아 있어야 합니다.

전체 가이드: Mods & cheats (영어).

오류 해결

먼저 최신 버전으로 업데이트하세요. 거의 모든 버전이 튕김과 그래픽 버그를 고쳤습니다.

플레이 중 VK_ERROR_DEVICE_LOST 또는 “write invalid” 튕김

0.3.13으로 업데이트하세요(#788, #802). 해제된 객체·메모리 풀·텍스처 기록이 기록 중인 GPU 명령이 실행될 때까지 기다립니다. 계속되면 이슈에 logs\totk.log를 첨부하세요. 0.3.13부터 오류 주소를 가진 객체가 로그에 표시됩니다.

Intel 그래픽에서 시작 시 igvk64.dll 튕김

0.3.13에서 수정(#681).

업데이트 후 undefined symbol 오류 또는 예전 totk.exe 실행

0.3.13에서 수정(#795). 설치 프로그램이 날짜 대신 파일 내용을 비교합니다. 0.3.13 설치 프로그램을 설치 폴더에 다시 실행하세요.

저용량 VRAM GPU에서 Purah Pad 망원경 사용·장시간 플레이 후 프레임이 영구 하락

0.3.12에서 수정(#754). 게임이 해제한 텍스처가 비디오 메모리에 남아 VRAM이 찬 뒤 재시작 전까지 느려지던 문제입니다. 여전히 떨어지면 F1 > Compress ASTC to BC3(astc_bc = 1)를 켜세요.

HD 텍스처 팩 사용 시 시작 직후 튕기거나 붉은 달(Blood Moon) 반복

0.3.12에서 수정(#673, #858). 팩의 HeapDef 파일을 읽어 월드 텍스처 힙을 자동으로 늘리며, The Second Quest 같은 콘텐츠 모드 위에 두어도 시작 시 튕기지 않습니다. HeapDef가 없는 팩은 [mods] 아래 tex_heap_extra_mb(0–4096)를 설정하고, VRAM 8 GB 미만에서는 Compress ASTC to BC3를 켜세요.

AMD GPU에서 검은 화면 또는 VK_ERROR_DEVICE_LOST (vk_recorder)

0.3.1에서 RDNA 2–4 시작 시 검은 화면을 막기 위해 AMD 기본값을 vk_recorder = 0으로 두었습니다. 0.3.12에서는 기록 스레드를 개선해 AMD 사용자에게 [performance] vk_recorder = 1로 프레임 상승을 시험해 달라고 안내하며, 검은 화면이나 VK_ERROR_DEVICE_LOST가 나면 0으로 되돌리고 logs\totk.log를 첨부하세요.

헤브라에 폭설이 시작될 때 모드 사용 중 튕김

0.3.11에서 수정(#776). 게임 팩 안의 파일을 바꾸면서 자체 크기 테이블이 없는 모드 때문에 해당 파일을 처음 불러올 때 게임이 튕기던 문제입니다.

fullscreen = 1인데 창 모드로 시작됨

0.3.11에서 수정(#738, #766, #622).

0.3.11 이후 업데이트 뒤 검은 여백이 생기거나 해상도가 바뀜

0.3.11부터 16:9가 아닌 화면에서는 직접 정하지 않은 게임 해상도가 화면 비율을 따릅니다(예전 크기는 output_res = 1920x1080). 0.3.12(#809, #814)부터는 전용 HUD 배치가 없는 해상도에서 HUD를 늘리는 대신 검은 여백과 함께 16:9 화면을 그립니다.

0.3.7 이후로 업데이트한 뒤 프레임 저하나 끊김

릴리스 노트에 따르면 totk.ini에 replay_async = 0을 넣으세요. 0.3.4에서는 괜찮았는데 튕기거나 화면이 이상하면 [performance] 아래에 replay_async = 0, gpl = 0, astc_bc = 0을 하나씩 넣어 보세요.

NVIDIA에서 DLSS·DLAA를 켜면 화면이 떨림

0.3.10에서 수정(#612, #701). 최신 버전으로 업데이트하세요.

메모리 사용량이 계속 늘어 결국 메모리 부족

0.3.10에서 수정(#670). 플레이 1분마다 약 44 MiB씩 늘던 문제입니다.

1.4.3에서 마우스 카메라 감각이 달라짐

0.3.10부터 직접 마우스 카메라가 기본이고 mouse_sens 단위가 달라졌습니다. 1부터 시작하세요. 예전 방식은 Controls 탭에서 Stick emulation을 고르거나 mouse_mode = stick으로 되돌립니다.

시작 몇 초 뒤 0xc0000409 예외로 종료

0.3.1에서 수정(#222, #176, #75). 업데이트하세요.

닌텐도 로고 뒤 종료(AMD RX 5000/6000/9000)

0.2.1에서 수정. 업데이트한 뒤 totk.ini에 예전에 직접 넣은 우회 설정(gpl, astc, vk_subgroup_pin, memory, 또는 device lost가 날 때의 vk_recorder)을 지우세요. 빌드가 GPU별로 정하며, 공식 알려진 문제 글에 따르면 astc = cpu는 이제 녹색 텍스처를 일으킵니다.

세이브가 사라지거나 진행이 날아감

0.2.8에서 수정(#260, #263). 백신, 탐색기 미리 보기, 클라우드 동기화 프로그램이 세이브 폴더를 잡고 있으면 저장이 조용히 실패하던 문제입니다. 업데이트하세요.

소리가 끊긴 뒤 다시 나오지 않음

0.3.4에서 수정(#131).

240Hz 모니터에서 로딩 중 종료

0.3.1에서 수정. 240fps를 넘으면 게임 물리가 깨지므로 프레임 제한이 240에서 멈춥니다.

설치 프로그램이 기본 게임이 “Tears of the Kingdom이 아니다”라고 함

업데이트 파일이나 합본 패키지를 기본 게임 칸에 고른 경우입니다. 첫 칸에는 1.0.0 기본 게임 파일을 고르세요.

모드가 적용되지 않음

Mods 탭(F1)이 쓸 수 없는 모드를 표시하고 이유를 알려 줍니다. UltraCam 같은 코드 플러그인이나 다른 게임 버전용 패치는 동작하지 않으며, main의 데이터를 바꾸는 ExeFS 패치는 0.3.12(#835)부터 동작합니다.

Windows SmartScreen이 TotK-Setup.exe를 막음

설치 프로그램에 코드 서명이 없기 때문입니다. 공식 Releases 페이지에서 받은 파일에 한해 추가 정보 → 실행을 누르세요.

안드로이드·모바일 Vulkan 드라이버

지원하지 않습니다. VK_EXT_external_memory_host가 필요합니다(#161). macOS도 지원하지 않습니다.

로그: 설치 폴더의 logs\totk.log(마지막 실행)와 totk.1.log–totk.4.log(그 이전 네 번). 공식 이슈 트래커에 올리기 전에 고정된 알려진 문제 글을 먼저 읽고, 버전·GPU·드라이버와 함께 totk.log를 첨부하세요. 로그나 이슈에 키를 붙여 넣지 마세요.

전체 목록: Troubleshooting (영어).

합법인가요?

프로젝트 코드는 MIT 라이선스이며 게임 데이터를 전혀 포함하지 않습니다. 본인 콘솔에서 덤프한 합법적인 사본은 본인이 준비해야 합니다. 완성된 게임 폴더(게임이 들어 있음)를 공유하거나 다른 사람에게서 게임 파일·키를 받지 마세요. 법률 조언이 아닙니다. 자세한 내용: Is it legal? (영어).

영어 상세 가이드

Advertisement

자주 묻는 질문

TotK Recomp는 에뮬레이터인가요?

아닙니다. Ryujinx 같은 에뮬레이터는 게임이 실행되는 동안 스위치를 흉내 냅니다. TotK Recomp는 게임의 ARM64 코드를 미리 C로 변환해 PC에서 totk.exe로 컴파일하고, 스위치의 시스템과 그래픽 API를 Vulkan 기반 자체 런타임으로 대체합니다.

TotK Recomp에 게임이 들어 있나요?

아닙니다. 다운로드에는 설치 프로그램과 빌드 도구만 들어 있습니다. 본인 콘솔에서 직접 덤프한 합법적인 게임 사본이 필요합니다: 기본 게임과 1.1.0, 1.2.1 또는 1.4.3 업데이트, 그리고 본인 콘솔의 키. 프로젝트는 이 파일을 구하는 방법을 설명하지 않으며 이 사이트도 마찬가지입니다.

TotK Recomp 최신 버전은 무엇인가요?

0.4.1이며 2026년 11월 15일(UTC) GitHub Releases에 공개되었습니다. 장시간 플레이 중 무작위 튕김을 고치고(#1005, #1137, #1145), NVIDIA Reflex(#638), 자이로 보정(#1197), 잔디 표시 거리(grass_range), 음악·효과음·음성 개별 볼륨(#722) 및 오디오 출력 장치 선택(#1014), HDR 색상 복원(#552), AMD 구름·안개 테두리 수정(#164, #1203), 1.1.0용 60+fps·울트라와이드 패치(#1002), 코드 치트 약 4초 재빌드(#996)를 추가했습니다. 0.4.0(11월 10일)은 메모리 사용량을 약 1.4 GB 줄이고(#921) 60fps 초과 등반 속도를 고쳤습니다(#35).

어떤 게임 버전을 지원하나요?

기본 게임에 1.1.0, 1.2.1 또는 1.4.3 업데이트. 1.2.1과 1.4.3 사이에는 세이브가 이어집니다. 다른 업데이트는 지원하지 않습니다.

스팀덱에서 돌아가나요?

0.2.1부터 리눅스용 AppImage와 스팀덱 기본 설정(1280x800, 수직 동기화, 40fps)이 있습니다. 0.3.7에서 스팀덱에서 보이던 지하 벽·바닥 누락이 고쳐졌습니다. 다만 개발 문서는 스팀덱 자체를 아직 검증되지 않음으로 표시하고, 릴리스 노트는 리눅스 빌드를 커뮤니티가 테스트한다고 밝히므로 실험적이라고 보세요.

AVX2 없는 CPU에서도 되나요?

네, 0.3.1부터 SSE4.2를 지원하는 x86-64 CPU면 됩니다. AVX2 CPU는 더 빠른 빌드를 받습니다.

DLSS는 어떻게 켜나요?

NVIDIA RTX가 필요합니다. 윈도우에서는 0.3.7부터 설치 프로그램이 nvngx_dlss.dll을 내려받습니다(Download NVIDIA DLSS 체크박스). 그다음 F1 메뉴나 totk.ini에서 dlaa = 1로 켜고 dlss(dlaa, quality, balanced, performance, ultra_performance)를 고릅니다.

UltraCam 같은 모드도 되나요?

안 됩니다. 0.3.1부터 RomFS 모드, TKMM 병합 결과, .ips·.pchtxt 패치(코드 및 0.3.12부터 데이터 수정 포함)와 0.3.12부터 HD 텍스처 팩은 동작하지만, UltraCam 같은 코드 플러그인(exefs의 subsdk*, main.npdm)은 불러오지 못합니다. 프레임, 해상도, 시야각은 설정에 이미 들어 있습니다.

한국어 게임 텍스트가 나오나요?

게임 언어를 한국어로 고를 수 있습니다. 중국어·한국어 텍스트에는 스위치 시스템 폰트가 필요해서, 설치 때 본인 콘솔의 펌웨어 폴더를 지정하면 설치 프로그램이 폰트를 복사합니다. 지정하지 않으면 경고만 하고 계속 진행합니다.

무료인가요?

네. MIT 라이선스의 비상업 프로젝트입니다. 공식 다운로드는 valentderah/totk-pc-recomp의 GitHub Releases뿐입니다.