andrewnakas/gtav-recomp

What it does

This project statically recompiles the PowerPC executable of Grand Theft Auto V for Xbox 360 (Title Update 27) into native C++ code that runs on Windows, Linux, macOS, iPhone and Android. It uses ReXGlue v0.10.0 plus a Vulkan renderer (MoltenVK on Apple devices); game shaders are translated to SPIR-V the first time they appear.

The setup flow copies the game files from Disc 1, Disc 2 and the title update, verifies them with SHA-256 hashes, then recompiles the executable on your machine with a bundled LLVM/clang toolchain into gtav_game.dll, .so or .dylib. No game data is included in the repository or releases; you supply the discs. Phone builds are generated from the same installed game on a computer, because iOS and Android cannot run the compiler or shader translator themselves.

Quick start on Windows

1. Download gtav-recomp-windows-x64.zip from the releases page and unzip it to a location with enough disk space.
2. Run gtav_launcher.exe and select Disc 1, Disc 2 and the Title Update 27 file or folder, then press Install. The recompilation takes 15-30 minutes once.
3. Press Play when setup finishes. Later, running gtav_launcher.exe starts the game directly; hold Shift while starting it to reopen setup or build for phones. Logs are in data\logs.

Linux and macOS follow the same flow with their respective packages; the platform sections give the exact commands, including the Linux terminal setup ./gtav_launcher --setup "Disc 1.iso" "Disc 2.iso" tu00000009_00000000.

Requirements

• A Windows 10/11 x64 machine with AVX2 CPU and a Vulkan driver, an x86-64 Linux system with glibc 2.35 and GCC 13 libstdc++, or Apple silicon with macOS 15 or newer.
• 8 GB RAM or more, about 25 GB free during setup and about 17 GB afterwards. A controller is recommended; keyboard input works on Mac and Linux.
• Only Title Update 27 works. Other title updates, damaged ISOs or modified dumps fail the hash check.
• iPhone builds need an iPhone 12 or newer on iOS 17+ and a sideloading tool such as Sideloadly or AltStore; a free Apple ID must re-sign the app every 7 days. Android builds need a recent Snapdragon phone with roughly 40 GB free during setup.
• The game files you generate are for your own use; the project asks users not to share game folders, GTAV.ipa or Android packs. The code is GPL-3.0 or later, and bundled third-party components keep their own licenses.

Building from source

The project builds from this repository plus patched upstream trees for ReXGlue, XenosRecomp and plume; each release attaches a source archive at the exact commits used. The README points to the clean-room and release process, iOS port notes and Android status for details.

HotRepo's take

The repository has no all-language daily ranking record; the only snapshot is a new-period C++ entry on 2026-11-03 showing 103 stars and 6 forks, with 2 stars gained in a roughly one-hour window. That window is too short to support a trend claim. The technical write-up is unusually concrete for a recompilation project: it documents hash verification, a bundled codegen/LLVM pipeline, the 15-30 minute one-time build, per-platform system requirements and measured phone performance. However, the primary deliverable is prebuilt launcher packages whose provenance and correspondence to the repository source are not established here, so users should weigh that against the unusually detailed documentation before running them.