{"full_name":"valentderah/totk-pc-recomp","owner":"valentderah","name":"totk-pc-recomp","shard":"1","url":"https://github.com/valentderah/totk-pc-recomp","description":"Static recompilation of The Legend of Zelda: Tears of the Kingdom to native Windows and Linux x86-64, with a Vulkan renderer. Game files not included.","homepage":"","topics":["game","linux","port","recompilation","windows"],"tag_pages":["game","linux","windows"],"language":"C","license":"MIT","avatar":"https://avatars.githubusercontent.com/u/41872026?u=d0ca8bdb9341181a8248a6dae9f5fa658181db0b&v=4","created_at":"2026-10-29T12:32:46Z","pushed_at":"2026-11-15T16:21:28Z","metrics":{"stars":7441,"forks":597,"watchers":87,"issues":764,"prs":316,"releases":14,"issues_open":282,"issues_closed":482,"prs_open":84,"prs_closed":91,"prs_merged":141,"discussions":136},"growth":{"day":{"stars":154,"forks":6,"base_day":"2026-11-15"},"week":{"stars":1400,"forks":98,"base_day":"2026-11-09"}},"history":{"dates":["2026-11-02","2026-11-03","2026-11-04","2026-11-09","2026-11-10","2026-11-11","2026-11-12","2026-11-13","2026-11-14","2026-11-15","2026-11-16"],"stars":[2547,3872,4439,6041,6286,6623,6850,6994,7126,7287,7441],"forks":[197,312,356,499,526,545,560,574,579,591,597],"watchers":[45,54,59,72,72,84,83,82,83,84,87],"issues_open":[null,null,null,null,null,296,288,292,303,269,282],"prs_open":[null,null,null,null,null,89,91,89,92,83,84]},"boards":{"daily":161,"weekly":125,"monthly":120,"daily_rate":72,"weekly_rate":65,"monthly_rate":18,"daily_watchers":88,"new":83},"same_owner":[],"issues":[{"number":560,"title":"Cheats Not Working","comments":19,"created_at":"2026-11-03T00:03:30Z"},{"number":1032,"title":"Crash: GPU device lost (`failed (-4)`)","comments":16,"created_at":"2026-11-09T16:14:59Z"},{"number":581,"title":"Game Flickering on Nvidia Card","comments":13,"created_at":"2026-11-03T05:52:45Z"},{"number":813,"title":"DualSense motion sensors (gyro) behave intermittently on Linux","comments":11,"created_at":"2026-11-05T22:42:51Z"},{"number":422,"title":"DLSS Quality/Performance: textures shake/shimmer (DLAA is fine)","comments":11,"created_at":"2026-11-01T19:44:19Z"},{"number":1215,"title":"Physics not quite right - Tenbez Shrine (Gravity and Velocity)","comments":10,"created_at":"2026-11-15T12:54:22Z"},{"number":285,"title":"Game crashes when a cutscene ends","comments":10,"created_at":"2026-10-31T21:25:35Z"},{"number":1174,"title":"FPS degrades over play‑session with bound:cpu, GPU idle, no memory leak (0.4.0 vs stable 0.3.11)","comments":9,"created_at":"2026-11-13T17:44:52Z"}],"discussions":[{"number":1218,"title":"v0.4.1","comments":4,"category":"Announcements","created_at":"2026-11-15T16:45:04Z"},{"number":1204,"title":"Tkmm with Recomp","comments":2,"category":"General","created_at":"2026-11-15T02:51:14Z"},{"number":1189,"title":"Rare Updates","comments":1,"category":"Q&A","created_at":"2026-11-14T09:24:35Z"},{"number":1179,"title":"log 11hrs gameplay","comments":0,"category":"General","created_at":"2026-11-14T01:14:13Z"},{"number":1176,"title":"Tera Recomp setup fails at \"Extracting system fonts\"","comments":1,"category":"Q&A","created_at":"2026-11-13T23:35:22Z"},{"number":1141,"title":"Challenge mod compatibility","comments":0,"category":"Ideas","created_at":"2026-11-12T09:57:47Z"},{"number":1110,"title":"Add a way to keep certain keys pressed","comments":1,"category":"Ideas","created_at":"2026-11-11T10:15:13Z"},{"number":1100,"title":"Guardians","comments":0,"category":"Ideas","created_at":"2026-11-11T01:53:55Z"}],"latest_release":{"name":"v0.4.1","tag":"v0.4.1","published_at":"2026-11-15T16:45:04Z","body":"To update, run the new installer on your existing install folder. It keeps your game files, saves and `totk.ini`, and rebuilds `totk.exe` and the shaders.\r\n\r\n> [!WARNING]\r\n> I have not tested the Linux build myself. DLSS is tested by the community only: I don't have the hardware for it.\r\n\r\n> [!NOTE]\r\n> **If something got worse.** Change one at a time (the settings menu, F1, or `totk.ini`), restart the game and check the same place. Then open an issue with `logs/totk.log` attached and say which switch helped.\r\n>\r\n> - **FPS falls after 5-10 minutes of play and a restart brings it back (#1174).** Add `addr_report = 0` under `[diagnostics]` in `totk.ini`.\r\n> - **Graphics artifacts, wrong textures or colours:** `memx = 0`.\r\n> - **AMD on Windows, new holes or noisy edges on foliage, fences or hair:** start the game with the environment variable `TOTK_DEMOTE=0`.\r\n> - **HDR colours look wrong:** `hdr_hue = 0`.\r\n> - **Objects, Recall or Ultrahand behave oddly:** `optref_guard = 0`, `ability_guard = 0` or `report_guard = 0`. Each turns off a crash guard, so the crash it stops can come back.\r\n\r\n<details>\r\n<summary><b>Experimental: the Linux PGO build and settings that are off by default.</b></summary>\r\n\r\n**Experimental Linux build with PGO.** `TotK-Setup-0.4.1-x86_64-pgo.AppImage` is built with profile-guided optimisation, as the Windows installer is. On Windows PGO gives 6-12% more FPS, and the Linux build should gain about as much, but nobody has measured it on Linux yet. If it misbehaves, use `TotK-Setup-0.4.1-x86_64.AppImage`. Please report your FPS with both builds in an issue.\r\n\r\n**Settings.** These switches can give more FPS on some PCs and do nothing or harm on others. Set them in the Advanced tab of the settings menu (F1) or in `totk.ini` under `[performance]`; they take effect at the next start unless noted. Try one at a time and compare the FPS at the same place. If one breaks something, set it back to its default and tell us in an issue with `logs/totk.log` attached.\r\n\r\n- **`replay_workers = 4`: record the GPU commands on several threads.** Each large submission is recorded in chunks on this many threads (0 to 16). In a town at 4K on an RTX 5070 the replay went from 8.2 to 4.5 ms a frame (71 to 79 fps); more than 4 threads add little. Needs 8 or more logical processors. No gain where the game's own threads limit the frame (a Ryzen 7900X at 1080p). This release fixes the freeze and the `chunk_record` crash it caused (#1104).\r\n- **`sync_ahead = 1` with `shadow = 1`: one frame ahead of the GPU.** The game builds the next frame while the GPU still draws the previous one. On Great Sky Island (Linux, RX 9070 XT) this took about 73 to 100 fps. Costs one more frame of input delay, frame times vary more, and GPU results the game reads back (occlusion queries) can be a frame old, so an object can pop in a frame late. On native Windows it needs `shadow = 1` (on by default on Linux and Wine): a copy of the game's GPU-visible memory, about 0.2 ms a frame and 1.1 GB more memory. Helps most where the game waits for the GPU. Works on 1.2.1 and 1.4.3.\r\n- **`replay_async = 1`: the GPU replay on its own thread.** Runs the replay at most one frame behind the game. Helped a GTX 1650 in the Depths, where the game waits for the GPU; on a GTX 1660 Ti at the 60 fps limit it made motion uneven (#659). Up to one frame more input delay.\r\n- **`bind_inc = 1`: rebuild only what changed between draws (#381).** The draw thread rebuilds only the bindings, shaders and pipeline state whose inputs changed since the previous draw: about 3% less time on that thread in a town (Ryzen 7900X limited to 4 cores). One GTX 1050 Ti lost the GPU (\"device lost\", -4) with it at one place in the world, and the cause is not found yet. If you get -4 with it, please attach `logs/totk.log`.\r\n- **`frame_queue = 1`: a frame waits in a queue for its display time.** The game starts the next frame while the previous one waits, so a frame that runs long still makes its turn: far fewer ","is_prerelease":false},"readme":true,"readme_zh":false,"news":[{"title":"TotK Recomp – 在 Windows 上原生运行《塞尔达传说：王国之泪》，不需要模拟器，支持 4K 纹理包","url":"https://www.appinn.com/totk-recomp/","source":"我最喜欢的《拼音输入法》 - 小众软件","lang":"zh","date":"2026-11-07"},{"title":"Versión optimizada de traducción al chino personalizada del port para PC de The Legend of Zelda: Tears of the Kingdom 0.10CE","url":"https://www.bilibili.com/es/video/BV1S7xn6rE6s/","source":"bilibili","lang":"en","date":"2026-10-31"},{"title":"jb™ on X: \"@danivempire666 game is running at minimum 100fps at 1440p with a 7800x3d and 3080ti\"","url":"https://x.com/postsbyjb/status/2116076916348489853","source":"x","lang":"en","date":"2026-10-30"},{"title":"【10月30最新开源/丝滑流畅】塞尔达王国之泪Windows原生移植运行情况","url":"https://www.bilibili.com/video/BV14axw6JEov/","source":"bilibili","lang":"zh","date":"2026-10-29"},{"title":"edinho on X: \"@danivempire666 I can download it on the deck and run with Port proton, right?\"","url":"https://x.com/edecarvalho/status/2115912609459495235","source":"x","lang":"en","date":"2026-10-29"},{"title":"无需模拟器 《塞尔达传说：王国之泪》可在Steam Deck上60帧运行","url":"https://news.google.com/rss/articles/CBMiXEFVX3lxTE12dkhiQ2J5RTZ2aHhzejJBT3NzdjNaQUtVTDdneXNnS2NYR2ZndnRXMUl2ckRpdE5ZQkxqY19Pc0ZBWVRtV0Y5ZFJZc2VpWC1DRmoyUWtWd0tVMEg0?oc=5","source":"3DM","lang":"zh","date":"2026-11-03"},{"title":"Steam Deck 上的《塞尔达传说》：据报道，TotK 如何在无需模拟器的情况下以最高 60 FPS 运行","url":"https://news.google.com/rss/articles/CBMiekFVX3lxTE1aeGVWamprc2h0ei13c0tJMjI0RkFpX3c1TXNJTVpBM1hNYm81cGhLVXlmdHRldEd0ZlJRV25SUFhRcmtwc19KZC1wLWV4eFdndlhzMF9lZm5vb3FGenk4UDlQOUtpS3NySHFlQmdpQnc1UU1fNmRxTjNR?oc=5","source":"Notebookcheck CN","lang":"zh","date":"2026-11-03"},{"title":"Zelda on Steam Deck: How TotK reportedly runs at up to 60 FPS without an emulator","url":"https://news.google.com/rss/articles/CBMiwwFBVV95cUxQN2ZtcDlrQkRVZTNFSWktRy1Yckx4RExwWWpSellnVHNkRnY2WTBua2kwOHRqN1dEenN5N1VwLXltZGtlU0IzVjdsb3Nmdzl2Vng5RFBaY1Z6TmtsT0NZTUxJX3BiY01DeFhRb0ZzWHlEOXBBMmptTkRhTk9Rc0dLMmY2VVA3b05BRTllR2NxQ25Ka0NrWGFPcy1qLXlhVkdKM2ZtS3lsUFRqOXd6NGZUbVBLamdDVmstYTN0bHRVT0hSbVE?oc=5","source":"Notebookcheck","lang":"en","date":"2026-11-03"}],"stale":false,"snapshot_at":"2026-11-16T09:23:14Z","history_start":"2026-09-06"}