Running Ocarina of Time Without an Emulator: Inside Hookshot's Static Recompilation
You've probably played Ocarina of Time through an emulator at some point. Maybe you've fiddled with plugin settings, dealt with frame pacing issues, or wondered why a 1998 game still needs a compatibility layer to run on modern hardware. Hookshot takes a different approach entirely: it statically recompiles the game's code to C, compiles that into a native Windows or Linux program, reimplements the console's system software, and rebuilds the Switch 2 graphics pipeline on Vulkan. No emulator involved.
What It Does
Hookshot is a static recompilation project for The Legend of Zelda: Ocarina of Time (the Nintendo Switch 2 version). The game's code is translated to C and compiled into a native executable. The console's system software is reimplemented from scratch, and the graphics are rebuilt on Vulkan. All of this happens on your PC, using your own copy of the game.
The repository doesn't contain the game, keys, or a prebuilt executable—you need to supply your own copy, and everything the build produces (the executable, generated code, shader caches, saves) stays on your machine. The project is explicitly experimental, with most testing concentrated around the start of the game, though players have reported progress further in.
Why It's Cool
-
No emulation layer. This isn't an emulator with a compatibility shim—it's the game's actual code translated to C and compiled natively. That means no per-instruction interpretation overhead, no plugin architecture, no BIOS files. The game runs as a native program on your OS.
-
Vulkan rendering rebuilt from scratch. The Switch 2 graphics pipeline is reimplemented on Vulkan, which is a substantial piece of engineering. It also brings modern features like frame generation and upscaling, plus an in-game menu.
-
Honest, detailed status reporting. The README's status table is refreshingly candid. Kokiri Forest works. Sound, controller, keyboard, and saves work. Flicker and ground fog issues were fixed in v2.0.2. But Hyrule Field has striped shadows, some areas crash, and performance varies wildly depending on your hardware. Stutter happens the first time you visit a new area—subsequent visits are smooth. This isn't a project pretending to be finished.
-
Hardware support is documented with real caveats. NVIDIA cards are the most tested. AMD works on some cards, with a known issue where the game loses the GPU in the Deku Tree on an RX 6600. Intel cards mostly produce black screens or crashes. Cards without mesh shaders (like AMD RX 5000 and older) aren't supported—a fallback exists since v2.0.6 that runs mesh programs as compute shaders, but it leaves out mesh draws that take their count from a buffer.
-
Linux is a first-class target. The AppImage works across CachyOS, Fedora, Bazzite, and SteamOS, though some AMD cards have open issues.
-
A note on the Trojan warning. Some users have flagged the release file as a Trojan. The README says it isn't, and encourages running it through antivirus software. That's the kind of transparency you want from a project distributing prebuilt binaries.
How to Try It
-
Head to the repository and read the install section carefully. The README is truncated in this excerpt, but the full version covers the build process.
-
You'll need your own copy of the game. The repo doesn't include it, doesn't include keys, and doesn't explain how to obtain them.
-
Build from source or use the provided release (the README notes the release binary has been falsely flagged by some antivirus tools). The build produces
hookshot.exeon Windows, along with generated code and shader caches. -
Check the status table before diving in. If you're on an NVIDIA card, you're in the best-supported territory. If you're on Intel or an older AMD card, temper your expectations.
-
Join the Discord (linked in the README) if you hit problems—the project has an active issue tracker with specific bug reports referenced throughout.
Final Thoughts
Hookshot is best suited for developers and tinkerers who find static recompilation interesting and don't mind experimenting with an early-stage project. It's not a plug-and-play solution for someone who just wants to replay Ocarina of Time—the performance varies, some areas crash, and the hardware requirements are specific. But as a technical achievement and an open demonstration of static recompilation applied to a modern console title, it's worth watching. The project is honest about its limitations, which is more than you can say for a lot of experimental software. If you've got the right GPU and some patience, it's a fascinating rabbit hole.
Follow @githubprojects for more developer tools and open source projects.