How sype0/libertyrecompandroid works
LibertyRecompAndroid ports the Xbox 360 static recompilation of GTA IV to native arm64 Android, rather than emulating the console. The user workflow is to provide their own game image and title update, install them through the launcher, then boot and play using a controller or touch overlay. Runtime subsystems cover guest execution, graphics, audio, input, and persistent saves. The README establishes the product capabilities and high-level workflow; sampled implementation evidence is limited, so component-level runtime connections are omitted where source did not verify them.
Main entry points: main.cpp Game runtime · LauncherActivity.java Android launcher · installer.cpp Game installer · guest_thread.cpp Guest CPU
Components 18
Installation and launch
- Android launcher
os/android/app/src/main/java/com/libertyrecomp/LauncherActivity.java - Installer wizard
LibertyRecomp/ui/installer_wizard.cpp - Game installer
LibertyRecomp/install/installer.cpp - Disc extraction
LibertyRecomp/install/iso_extractor.cpp - Title updates
LibertyRecomp/install/xbox360/title_update_manager.cpp
Game runtime
- Game runtime
LibertyRecomp/main.cpp - Guest CPU
LibertyRecomp/cpu/guest_thread.cpp - Kernel services
LibertyRecomp/kernel/compat_stubs.cpp - Graphics renderer
LibertyRecomp/gpu/gfx_state.cpp - Post-processing
LibertyRecomp/gpu/postprocess_renderer.cpp - Audio playback
LibertyRecomp/apu/embedded_player.h
Android device services
- Controller input
LibertyRecomp/hid/hid.cpp - Touch controls
LibertyRecomp/hid/context_touch_host.cpp - Android services
LibertyRecomp/os/android/jni_glue.cpp
Player experience
- User settings
LibertyRecomp/user/config.cpp - Persistent saves
LibertyRecomp/os/android/user_android.cpp - Achievements
LibertyRecomp/user/achievement_manager.cpp
Other components
- Player
Connections 17
- Player → Android launcher: opens
README.md - Android launcher → Installer wizard: offers install
README.md - Player → Game installer: provides game
README.md - Game installer → Disc extraction: extracts image
- Player → Title updates: provides update
README.md - Android launcher → Game runtime: boots game
README.md - Player → Controller input: plays with controller
README.md - Player → Touch controls: uses touch overlay
README.md - Player → User settings: sets options
README.md - Game runtime → Persistent saves: persists saves
README.md - Game runtime → Graphics renderer: renders game
README.md - Graphics renderer → Post-processing: applies FXAA
- Game runtime → Audio playback: plays audio
README.md - Game runtime → Guest CPU: runs guest code
- Guest CPU → Kernel services: uses services
- Game runtime → Android services: runs on Android
README.md - Game runtime → Achievements: supports achievements