On this page
- Quick Start
- What Is Hookshot Recomp?
- Hookshot Emulator: Is It an Emulator?
- Hookshot Requirements
- Ocarina of Time Remake PC Requirements: Which Game Build Works?
- Hookshot Setup on Windows
- Hookshot Linux Setup
- GPU and Platform Compatibility
- Hookshot Troubleshooting
- Hookshot FAQ
- Legal and Project Disclaimer
- Explore Hookshot Guides
Quick Start
What Is Hookshot Recomp?
Hookshot recomp builds a native Windows or Linux program on your own PC from your own supported game copy. The repository does not supply the game, keys or a ready-made game executable. You choose your copy in Hookshot Builder, and the files produced from it stay on your PC. The project is an unofficial community effort. This Ocarina of Time remake PC guide follows the Hookshot recomp workflow from game copy to native program. Check the README for its current status before building.
The project repository now lives on the project's own Git host, git.notrexed.dev. The former GitHub repository address is unavailable. The project's organization page identifies the new site as its Git host and links to the active Hookshot code. In a community discussion, a user relayed a message attributed to the developer saying the former hosting account had become unavailable and development would continue elsewhere. That is a user's report of the message, not an independently verified explanation of why the account went away. The available sources describe a hosting and account interruption; they do not identify a defect in Hookshot's code as the reason for the move. Use the new repository to read the README and check the current setup instructions. Use its Releases page as the only download entry point linked by this guide. The repository explains the project and its requirements; the release listing shows the files offered by the project.
Longshot is the continuation of Hookshot — the project's own wording — and it started from Hookshot v2.0.5. It is maintained separately by Team MagicBean. Longshot recomp: installation, repository and save transfer.
Hookshot Emulator: Is It an Emulator?
Hookshot is a static recompilation, not an emulator: it builds a native Windows or Linux program from your own supported game copy. It includes neither the game nor keys. Read Hookshot emulator setup for how the native program is built and run.
Hookshot Requirements
Hookshot needs a supported 64-bit Windows or Linux system, a Vulkan 1.3 GPU with mesh shaders, and at least 16 GB of system RAM. The README recommends 8 GB or more of VRAM and about 60 GB free while building; the Linux AppImage also needs AVX2. For the Builder and source files, see download.
Ocarina of Time Remake PC Requirements: Which Game Build Works?
The supported game copy must match program 0400486024DEC000, update v131072 and build e0f3ccfa. The README says other versions do not work. These identify the game input, not a Hookshot release. Builder accepts a matching .nup file or romfs and exefs folders and checks the version. If your identifiers differ, use a matching copy of your own game. Before using this guide, check the README for the current value.
Hookshot Setup on Windows
Download HookshotBuilder.exe from the official project Releases page. Run it and select your own supported .nup file, or your romfs and exefs folders. Builder checks the game version. Choose where to install the game, then start the build. The README's build-time reference is about 10–45 minutes, depending on your CPU and memory; it is not a promise. Keep about 60 GB free while building. Builder brings its own compiler and tools and needs internet access for its download.
For a portable Windows setup, run HookshotBuilder.exe --portable from a writable folder. It creates a Builder data folder beside the setup. Keep the Builder and game on the same volume. This mode can still leave operating-system caches or temporary files; it is not a sandbox. See the portable Builder instructions.
Hookshot Linux Setup
Download the Linux AppImage from the official project Releases page. Make it executable in your file manager or with chmod +x followed by the downloaded AppImage filename. Open it, select your own matching .nup file or romfs and exefs folders, choose a destination and build. The AppImage needs 64-bit Linux with glibc 2.35 or newer and an AVX2 CPU. The README gives about 10–45 minutes as a build-time reference, depending on the machine.
For fast GPU memory imports, the game user needs read and write access to /dev/udmabuf. Without it, Hookshot falls back to host-pointer imports, which can be much slower on AMD/RADV. NVIDIA's proprietary driver uses host-pointer imports and does not need this access; its users can ignore that particular warning. Check the device and your user identity, then follow the README's device-specific permission guidance. Do not run the game as root or make the device world-writable.
GPU and Platform Compatibility
Windows and Linux are documented platforms, but a supported operating system does not guarantee that every GPU and driver works. AMD and Intel have reported issues, and cards without mesh shaders are unsupported. See the GPU compatibility list for the platform conditions and sourced reports.
Hookshot Troubleshooting
Black screens, device loss, stutter and failed builds have different causes and checks. Record your release, GPU, driver and log before changing settings. Match your symptom in crash fixes.
Hookshot FAQ
Is Hookshot an emulator?
No. The README calls it a static recompilation that builds a native program from your own game copy.
Does Hookshot include the Ocarina of Time game or keys?
No. The repository contains neither; you need your own copy.
Which Ocarina of Time remake game build does Hookshot support?
Program 0400486024DEC000, update v131072 and build e0f3ccfa are the supported identifiers. Check the README for the current values before building.
What PC requirements does Hookshot have?
It needs a documented 64-bit Windows or Linux environment, a Vulkan 1.3 card with mesh shaders, and 16 GB or more of system RAM. The README recommends 8 GB or more of VRAM and asks for about 60 GB free while building. The Linux AppImage requires AVX2. See the full requirements.
How do I set up Hookshot on Windows?
Get HookshotBuilder.exe from official project Releases, select your own matching game copy and build it locally.
How do I install Hookshot on Linux?
Get the official AppImage from project Releases, grant execute permission, select your matching game copy and build. Check /dev/udmabuf permission if the relevant warning appears.
Legal and Project Disclaimer
Hookshot is an unofficial community project, not affiliated with or endorsed by Nintendo. Its software code is licensed under GPL-3.0-or-later, with separate notices for third-party components. That code license does not grant permission to distribute game content or decide the law where you live. The project repository contains no game or keys. Use your own copy and keep locally generated game files, caches and saves on your own device; do not share them. This guide offers no game files, ROMs, keys or patches and gives no instructions for obtaining them. Builder downloads here lead only to the maintainer's project Releases. Read the project README.
Explore Hookshot Guides
Download and install Hookshot · Understand Hookshot recomp and emulation · Adjust graphics and controls · Troubleshoot crashes · Check system and GPU compatibility · Hookshot release notes and changelog