Bloodborne recomp ships a trimmed LLVM toolchain for macOS

The Bloodborne PS4 recomp project published a trimmed LLVM 23.1.4 toolchain for macOS arm64, which its launcher uses to build the library on your Mac.

grumpy_bootrom28 Oct 2026, 13:15· awesome-decomp

This release does not update the bloodborne-recomp recompiler. It ships the compiler the launcher downloads to build the recompiled library on the player’s own Mac. The toolchain itself is for macOS arm64. The recompiler targets the PS4 build of Bloodborne (CUSA03173, patch 1.09).

A static recompiler reads your own copy of the game’s executable and writes its functions out as C. A compiler then turns that C into a native library. The repository holds only the tool. No game code lives there, and the project says none is ever published, so every player builds from their own dump. The compiler therefore runs on the player’s machine.

The toolchain is the official LLVM macOS arm64 archive, 1.5 GB, trimmed to clang, ld64.lld, clang’s headers and the license. Unpacked, it takes 360 MB. The toolchain.sh script checks the official archive against a pinned SHA-256. LLVM is licensed under Apache 2.0 with LLVM exceptions.

The README gives the project status. The executable has 241,821 functions. The build generates 241,031 of them, 99.1% of their instructions are plain C, and the game runs on that code. The project says the recompiled code uses less CPU than the translator path: 344% of one core against 402% at one spot in the game, and 357% against 392% in another, measured on 2026-10-25. Those numbers come from the project itself. The CPU layer, bbcpu, holds an x86-64 decoder, an interpreter and an x86-64 to arm64 translator.

To build it by hand, the README gives these steps. The full commands are in the repo.

  1. Install clang, cmake, ninja and Python 3. On macOS: xcode-select --install and brew install cmake ninja.
  2. Run ./build.sh. Zydis gets built into deps/ the first time.
  3. Set GAME=/path/to/CUSA03173 to your dump with the 1.09 update, then run the ps4elf, pointers, scan and imports steps.
  4. Run tools/recomp/recomp.sh --file out/recomp/all.txt to get out/recomp/librecomp.dylib.
  5. Point bloodborne-runtime at the library with BB_RECOMP_LIB=out/recomp/librecomp.dylib.

The approach follows the static recompilers of other games, as the credits say: N64Recomp, XenonRecomp and UnleashedRecomp.

The toolchain carries no game code, the hashes are pinned, and the build stays on your disk. The starting archive is 1.5 GB. The sources name only macOS arm64 for this toolchain, so support for other platforms is unclear.

Sources: github.com