# sype0/libertyrecompandroid architecture

> Architecture diagram of the GitHub repository sype0/libertyrecompandroid, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sype0/libertyrecompandroid
- Repository: https://github.com/sype0/libertyrecompandroid

## Overview

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: [`LibertyRecomp/main.cpp`](https://github.com/sype0/libertyrecompandroid/blob/main/LibertyRecomp/main.cpp) (Game runtime), [`os/android/app/src/main/java/com/libertyrecomp/LauncherActivity.java`](https://github.com/sype0/libertyrecompandroid/blob/main/os/android/app/src/main/java/com/libertyrecomp/LauncherActivity.java) (Android launcher), [`LibertyRecomp/install/installer.cpp`](https://github.com/sype0/libertyrecompandroid/blob/main/LibertyRecomp/install/installer.cpp) (Game installer), [`LibertyRecomp/cpu/guest_thread.cpp`](https://github.com/sype0/libertyrecompandroid/blob/main/LibertyRecomp/cpu/guest_thread.cpp) (Guest CPU)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Installation and launch"]
  node_launcher["Android launcher"]
  node_installer_ui["Installer wizard"]
  node_installer["Game installer<br/>[installer.cpp]"]
  node_image_extract["Disc extraction<br/>[iso_extractor.cpp]"]
  node_title_update["Title updates"]
end

subgraph group_runtime["Game runtime"]
  node_game["Game runtime<br/>[main.cpp]"]
  node_guest_cpu["Guest CPU<br/>[guest_thread.cpp]"]
  node_kernel["Kernel services<br/>[compat_stubs.cpp]"]
  node_graphics["Graphics renderer<br/>[gfx_state.cpp]"]
  node_postprocess["Post-processing"]
  node_audio["Audio playback<br/>[embedded_player.h]"]
end

subgraph group_device["Android device services"]
  node_input["Controller input<br/>[hid.cpp]"]
  node_touch["Touch controls"]
  node_android["Android services<br/>[jni_glue.cpp]"]
end

subgraph group_player["Player experience"]
  node_settings["User settings<br/>[config.cpp]"]
  node_saves["Persistent saves<br/>[user_android.cpp]"]
  node_achievements["Achievements"]
end

node_player(("Player"))

node_player -->|"opens"| node_launcher
node_launcher -->|"offers install"| node_installer_ui
node_player -->|"provides game"| node_installer
node_installer -.->|"extracts image"| node_image_extract
node_player -->|"provides update"| node_title_update
node_launcher -->|"boots game"| node_game
node_player -->|"plays with controller"| node_input
node_player -->|"uses touch overlay"| node_touch
node_player -->|"sets options"| node_settings
node_game -->|"persists saves"| node_saves
node_game -->|"renders game"| node_graphics
node_graphics -.->|"applies FXAA"| node_postprocess
node_game -->|"plays audio"| node_audio
node_game -.->|"runs guest code"| node_guest_cpu
node_guest_cpu -.->|"uses services"| node_kernel
node_game -->|"runs on Android"| node_android
node_game -.->|"supports achievements"| node_achievements

click node_launcher "https://github.com/sype0/libertyrecompandroid/blob/main/os/android/app/src/main/java/com/libertyrecomp/LauncherActivity.java"
click node_installer_ui "https://github.com/sype0/libertyrecompandroid/blob/main/LibertyRecomp/ui/installer_wizard.cpp"
click node_installer "https://github.com/sype0/libertyrecompandroid/blob/main/LibertyRecomp/install/installer.cpp"
click node_image_extract "https://github.com/sype0/libertyrecompandroid/blob/main/LibertyRecomp/install/iso_extractor.cpp"
click node_title_update "https://github.com/sype0/libertyrecompandroid/blob/main/LibertyRecomp/install/xbox360/title_update_manager.cpp"
click node_game "https://github.com/sype0/libertyrecompandroid/blob/main/LibertyRecomp/main.cpp"
click node_guest_cpu "https://github.com/sype0/libertyrecompandroid/blob/main/LibertyRecomp/cpu/guest_thread.cpp"
click node_kernel "https://github.com/sype0/libertyrecompandroid/blob/main/LibertyRecomp/kernel/compat_stubs.cpp"
click node_graphics "https://github.com/sype0/libertyrecompandroid/blob/main/LibertyRecomp/gpu/gfx_state.cpp"
click node_postprocess "https://github.com/sype0/libertyrecompandroid/blob/main/LibertyRecomp/gpu/postprocess_renderer.cpp"
click node_audio "https://github.com/sype0/libertyrecompandroid/blob/main/LibertyRecomp/apu/embedded_player.h"
click node_input "https://github.com/sype0/libertyrecompandroid/blob/main/LibertyRecomp/hid/hid.cpp"
click node_touch "https://github.com/sype0/libertyrecompandroid/blob/main/LibertyRecomp/hid/context_touch_host.cpp"
click node_android "https://github.com/sype0/libertyrecompandroid/blob/main/LibertyRecomp/os/android/jni_glue.cpp"
click node_settings "https://github.com/sype0/libertyrecompandroid/blob/main/LibertyRecomp/user/config.cpp"
click node_saves "https://github.com/sype0/libertyrecompandroid/blob/main/LibertyRecomp/os/android/user_android.cpp"
click node_achievements "https://github.com/sype0/libertyrecompandroid/blob/main/LibertyRecomp/user/achievement_manager.cpp"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_launcher,node_installer_ui,node_installer,node_image_extract,node_title_update toneBlue
class node_game,node_guest_cpu,node_kernel,node_graphics,node_postprocess,node_audio toneAmber
class node_input,node_touch,node_android toneMint
class node_settings,node_saves,node_achievements toneRose
class node_player toneIndigo
```

## Components

### Installation and launch

- [Android launcher](https://github.com/sype0/libertyrecompandroid/blob/main/os/android/app/src/main/java/com/libertyrecomp/LauncherActivity.java): `os/android/app/src/main/java/com/libertyrecomp/LauncherActivity.java`
- [Installer wizard](https://github.com/sype0/libertyrecompandroid/blob/main/LibertyRecomp/ui/installer_wizard.cpp): `LibertyRecomp/ui/installer_wizard.cpp`
- [Game installer](https://github.com/sype0/libertyrecompandroid/blob/main/LibertyRecomp/install/installer.cpp): `LibertyRecomp/install/installer.cpp`
- [Disc extraction](https://github.com/sype0/libertyrecompandroid/blob/main/LibertyRecomp/install/iso_extractor.cpp): `LibertyRecomp/install/iso_extractor.cpp`
- [Title updates](https://github.com/sype0/libertyrecompandroid/blob/main/LibertyRecomp/install/xbox360/title_update_manager.cpp): `LibertyRecomp/install/xbox360/title_update_manager.cpp`

### Game runtime

- [Game runtime](https://github.com/sype0/libertyrecompandroid/blob/main/LibertyRecomp/main.cpp): `LibertyRecomp/main.cpp`
- [Guest CPU](https://github.com/sype0/libertyrecompandroid/blob/main/LibertyRecomp/cpu/guest_thread.cpp): `LibertyRecomp/cpu/guest_thread.cpp`
- [Kernel services](https://github.com/sype0/libertyrecompandroid/blob/main/LibertyRecomp/kernel/compat_stubs.cpp): `LibertyRecomp/kernel/compat_stubs.cpp`
- [Graphics renderer](https://github.com/sype0/libertyrecompandroid/blob/main/LibertyRecomp/gpu/gfx_state.cpp): `LibertyRecomp/gpu/gfx_state.cpp`
- [Post-processing](https://github.com/sype0/libertyrecompandroid/blob/main/LibertyRecomp/gpu/postprocess_renderer.cpp): `LibertyRecomp/gpu/postprocess_renderer.cpp`
- [Audio playback](https://github.com/sype0/libertyrecompandroid/blob/main/LibertyRecomp/apu/embedded_player.h): `LibertyRecomp/apu/embedded_player.h`

### Android device services

- [Controller input](https://github.com/sype0/libertyrecompandroid/blob/main/LibertyRecomp/hid/hid.cpp): `LibertyRecomp/hid/hid.cpp`
- [Touch controls](https://github.com/sype0/libertyrecompandroid/blob/main/LibertyRecomp/hid/context_touch_host.cpp): `LibertyRecomp/hid/context_touch_host.cpp`
- [Android services](https://github.com/sype0/libertyrecompandroid/blob/main/LibertyRecomp/os/android/jni_glue.cpp): `LibertyRecomp/os/android/jni_glue.cpp`

### Player experience

- [User settings](https://github.com/sype0/libertyrecompandroid/blob/main/LibertyRecomp/user/config.cpp): `LibertyRecomp/user/config.cpp`
- [Persistent saves](https://github.com/sype0/libertyrecompandroid/blob/main/LibertyRecomp/os/android/user_android.cpp): `LibertyRecomp/os/android/user_android.cpp`
- [Achievements](https://github.com/sype0/libertyrecompandroid/blob/main/LibertyRecomp/user/achievement_manager.cpp): `LibertyRecomp/user/achievement_manager.cpp`

### Other components

- **Player**

## Connections

- Player → Android launcher: opens (evidence: `README.md`)
- Android launcher → Installer wizard: offers install (evidence: `README.md`)
- Player → Game installer: provides game (evidence: `README.md`)
- Game installer → Disc extraction: extracts image
- Player → Title updates: provides update (evidence: `README.md`)
- Android launcher → Game runtime: boots game (evidence: `README.md`)
- Player → Controller input: plays with controller (evidence: `README.md`)
- Player → Touch controls: uses touch overlay (evidence: `README.md`)
- Player → User settings: sets options (evidence: `README.md`)
- Game runtime → Persistent saves: persists saves (evidence: `README.md`)
- Game runtime → Graphics renderer: renders game (evidence: `README.md`)
- Graphics renderer → Post-processing: applies FXAA
- Game runtime → Audio playback: plays audio (evidence: `README.md`)
- Game runtime → Guest CPU: runs guest code
- Guest CPU → Kernel services: uses services
- Game runtime → Android services: runs on Android (evidence: `README.md`)
- Game runtime → Achievements: supports achievements
