Find your next open-source project

Search by name, purpose, or keyword — or paste a GitHub repository URL

ItsNotRexed/Hookshot

Games

Static recompilation that runs The Legend of Zelda: Ocarina of Time natively on Windows and Linux using your own game copy.

102
0
C++
GPL-3.0
new today

What it is

Hookshot is a static recompilation of The Legend of Zelda: Ocarina of Time from the Nintendo Switch 2. It translates the game's ARM64 code to C, reimplements the console's system software, and replays the NVN2 graphics calls on Vulkan, producing a native Windows or Linux program instead of an emulator. The repository does not ship the game, keys, or a ready executable: everything (the game binary, generated code, shader caches) is built on your machine from your own copy of the supported version, program 0400486024DEC000, update v131072, build e0f3ccfa (1).

Beyond running the game, it adds high frame rates with real-time speed, ultrawide/16:10/4:3 support, upscalers and frame generation (DLSS, FSR 3.1, FSR 4, XeSS), HDR, CRT/TV filters, remappable controls with gyro aiming, an in-game ImGui menu, emulator-style RomFS/ExeFS/cheat mods, and a save editor in Hookshot Builder. It is aimed at players who own the game and are comfortable with a build step, and at testers willing to report GPU and gameplay results.

Build and play

You need a game dump in the supported version as a .nup file, a .nx file made from one, or romfs and exefs folders; 64-bit Windows 10/11 or 64-bit Linux with glibc 2.35+ and an AVX2 CPU; a Vulkan 1.3 GPU with mesh shaders (RTX 20 series+, RX 6000 series+, or Intel Arc); 16 GB RAM (a run uses about 10 GB); and about 60 GB free during the build.

On Windows, download HookshotBuilder.exe from the latest release, run it, select your game under Found on this PC or with Browse…, choose an install folder and language, then press Build the game. The build takes roughly 10–45 minutes; press Play when it finishes. Later, start the game from the shortcut, which is also the launcher for Play and Update. On Linux, download the AppImage, mark it executable (chmod +x Hookshot-*-x86_64.AppImage), run it, and follow the same steps; the game is added to the applications menu. The first start prepares shaders and is slower than later starts.

For command-line builds, the same script used by the builder can be invoked directly, for example python -I nx2/make_game.py --nup "C:\path\your-game.nup" --out "C:\Games\Hookshot" --language en-US; prerequisites and Linux variants are documented in the build-from-source section.

Constraints and status

The project is explicitly experimental. Some areas work, but Hyrule Field, Castle Town, Kakariko, and the dungeons still have open lighting/shadow bugs and crash reports, performance varies by machine, and entering a new area stutters the first time. AMD cards have known crash issues, and incomplete dumps trigger hookshot_damaged_files.txt; the README also mentions some users flagging the release file as a Trojan, which the project denies. Graphics features have hardware-specific constraints: mesh shaders are mandatory, DLSS/FSR 4 require NVIDIA/AMD SDKs downloaded at build time under their own licenses, and on Linux fast GPU memory imports need /dev/udmabuf access. Saves live in the game folder (Windows) or ~/.local/share/hookshot (Linux) and are backed up automatically. Hookshot is GPL-3.0-or-later and an unofficial fan project not affiliated with Nintendo (33).

HotRepo's take

HotRepo has one recorded snapshot: on 2026-11-21 the project appeared on the C++ new-repository list with 102 stars gained in a window that began the previous day, and no daily all-language rank was recorded. That single data point shows a quick initial burst but says nothing about retention, testing coverage, or whether the open crash and graphics issues get resolved. The README's detailed hardware requirements, version checksum, and status table are useful signals for readers deciding whether their machine and dump match the project.

Written by AI from the project's public information and HotRepo's records, updated . The project's own docs are the source of truth.

You might also like

  1. NotRexed/HookshotRecompiles the Switch 2 version of Ocarina of Time to run natively on Windows and Linux PCs.C++8,753
  2. sostenesfreitas/ocarina-recompRecompiles a user's own Ocarina of Time copy into a native Windows program using Vulkan, without an emulator.C1,164
  3. pixl27/ProjectReLinkBuilds a native Windows version of the Zelda: Ocarina of Time Switch 2 remake from your own game copy.C++114
  4. Revivedx/SavageWindRecompStatic recompilation of Breath of the Wild for Windows and Linux, built from your own dumped game files.C4,846
  5. tangerineturtle1/NX2naviStatic recompilation of Ocarina of Time for Switch 2 into a native Windows Vulkan app, needing your own game dump.C4,332