Repository navigation
Releases
0.0.5.3 Cutscene + Audio Fix Again (Experimental)
BioShock 1 Native Static ReComp — v0.0.5.3 Experimental (Cutscene + Audio Fix Again)
Community & Feedback Discord: https://discord.gg/aaDRJQNw8T
Required Game Copy: Xbox 360 World Release of BioShock 1 (Title ID 545407D8, Media ID 44E704F7).
What's new in 0.0.5.3
- Audio Survival Fix (Confirmed Working): Fixed an APU semaphore credit leak in
APU::WorkerMainwhere silent guest callbacks (e.g. 2K intro → Title Screen or gameplay loading transitions) returned without submitting a frame and permanently drained audio credits until audio died. Silent callbacks now pace by 5 ms and refund their credit so audio survives all transitions with no stretching. - AAudio & Scheduling Tuning: Restored
AAUDIO_PERFORMANCE_MODE_LOW_LATENCYwith 256-frame callback alignment, automatic sample-rate resampling for non-48 kHz devices,--apu.max_queued_frames=32, and normal GPU thread priority (removingsustainedPerformanceModeclock throttling and GPU thread-8priority starvation). - Ahead-of-Time Shader Cache Pre-Warming (Android): Cached
.glesbinshader programs are now pre-loaded at startup before the first frame (PrewarmCache— 741+ shaders in ~0.66 s on Adreno 710) and redundantglCompileShadercalls are skipped on cache hits, eliminating repeat load-in shader stutters. - Hardware Write-Watch for GLES3 Resources: Textures, vertex buffers, and index buffers now use
IPhysicalWriteWatchpage-level tracking instead of polling guest RAM on CPU, plus CPU-overwrite invalidation for resolved render targets and VSync enabled (--gpu.custom.vsync=true). - Known Issue (Narrowed for 0.0.5.4): During Andrew Ryan's Bathysphere projector cutscene, a 1-frame draw dump confirmed the projector video renders in-scene behind a dark brown overlay (pointing to the fullscreen depth-sampled fog pass
ps=38fc8859e11347ceor deferred spotlight volumeps=10ee2aad4ad76b55).
Install
- Android: Install
BioShock1-Android-v0.0.5.3-experimental.apkon an arm64-v8a Android 9+ device (GLES 3.2), tap IMPORT ISO and select your World Release ISO, then tap START GAME. - Windows: Extract
bioshock1-windows-v0.0.5.3-experimental.zipand runrun-windows.ps1pointing to your extracted World Release game folder.
v0.0.5-experimental — Android & Windows (Cutscene, Performance, Audio & Save/Load)
BioShock 1 Native Static ReComp - Android & Windows v0.0.5 Experimental
Community & Feedback Discord: https://discord.gg/aaDRJQNw8T
Required Game Copy: Xbox 360 World Release of BioShock 1 (Title ID 545407D8, Media ID 44E704F7).
Hotfix (Android)
- Ahead-of-Time Shader Cache Pre-Warming: Cached Adreno .bin shader programs are now pre-loaded at startup before the first frame, and redundant
glCompileShadercalls are skipped whenever a cached binary hits — eliminating load-in shader compilation stutters on repeat boots. - Hardware Write-Watch for GLES3 Resources: Textures, vertex buffers, and index buffers now use
IPhysicalWriteWatchpage-level tracking instead of polling guest RAM on CPU every few frames. - Resolved Render-Target Invalidation: CPU writes to a previously resolved render-target address now invalidate the stale resolved surface so dynamic/Bink video textures upload cleanly.
- Clock & VSync Tuning: Removed
sustainedPerformanceMode(which throttled CPU/GPU clocks) and enabled VSync (--gpu.custom.vsync=true) to prevent 220+ FPS thermal drain on menus. - AAudio Sample-Rate Resampling: Restored
LOW_LATENCYburst sizing while adding automatic linear resampling if a device opens at a sample rate other than 48 kHz.
What's new in 0.0.5
- Performance pass
- GPU command thread now runs at display priority so frame submission is never delayed by background work.
- Bink video textures upload with a fast row-copy path (Andrew Ryan projector, cutscenes).
- Default internal resolution is now 540p on fresh installs with 2x anisotropy (change live with the RES pill on Android or F1 on Windows).
- Resolved depth is replicated across all channels for underwater fog and depth-based effects.
- Includes everything from 0.0.4.20: working in-game Save/Load, native AAudio sound, full Xbox 360 touch controller, live 360p-1440p (Android) / 360p-2160p (Windows) scaling.
Install
- Android: Install
BioShock1-Android-v0.0.5-experimental.apkon an arm64-v8a Android 9+ device (GLES 3.2), tap IMPORT ISO and select your World Release ISO, then tap START GAME. - Windows: Extract
bioshock1-windows-v0.0.5-experimental.zipand runrun-windows.ps1pointing to your extracted World Release game folder.
BioShock 1 Android Port v0.0.4.20 Experimental
BioShock 1 Native Static ReComp — Android v0.0.4.20 Experimental
Community & Feedback Discord: https://discord.gg/aaDRJQNw8T (report bugs, share device performance, and follow progress!)
Required Game Copy: Built against the Xbox 360 World Release of BioShock 1 (Title ID: 545407D8, Media ID: 44E704F7). Make sure your legally owned disc/ISO matches this World Release edition.
What's New in �0.0.4.20-experimental
- Working Real In-Game Save & Load (Android & Windows):
- Fixed NtSetInformationFile(XFileRenameInformation) to strip ??\ and handle ObDosDevices (
BioShock 1 Android Port v0.0.4-experimental
BioShock 1 Native Static ReComp — Android Release (v0.0.4-experimental)
Community & Feedback Discord: https://discord.gg/aaDRJQNw8T (report bugs, share device performance, and follow progress!)
Required Game Copy: Built against the Xbox 360 World Release of BioShock 1 (Title ID: 545407D8, Media ID: 44E704F7). Make sure your legally owned disc/ISO matches this World Release edition.
Highlights
- Standalone Custom GLES 3.2 Xenos Renderer (librexgpu-xenos-custom.so) with true live, zero-restart internal resolution scaling (360p / 540p / 720p / 900p / 1080p / 1440p) + Lanczos2 / Bilinear upscaling.
- Native Android AAudio Sound: direct low-latency 48 kHz float32 stereo game audio via libaaudio.so.
- Full 3D Rendering Accuracy verified on Adreno 710 (Samsung Galaxy A36 5G): solid Lighthouse geometry, moonlit storm skybox, ocean water reflections, fire/particles, spotlight lighting, and HUD.
- Adreno GPU & CPU Optimizations (~2.7x speedup): hardware Early-Z/LRZ (BS1_ALPHA_TEST split), native FMA + fast extureAdjust, 32-bit GL_DEPTH24_STENCIL8, glCopyImageSubData hardware resolves + glInvalidateFramebuffer, combined color+depth clears, and GL_EXT_buffer_storage persistent coherent mapped UBO/Index/Vertex ring buffers.
- 3D Title Screen: 118 FPS (720p)
- 3D Airplane Cabin: 61–74 FPS (720p)
- Ocean + Burning Wreckage + Lighthouse: 25–26.5 FPS (720p) / 28.5–34 FPS (540p)
- Full Xbox 360 On-Screen Touch Controller: dual floating analog sticks (MOVE / LOOK), color-coded A/B/X/Y diamond, LT (Plasmid) / LB (Wheel) / RT (Fire) / RB (Wheel), slide-friendly 4-way D-Pad (First Aid / EVE / Ammo), L3 (Crouch) / R3 (Zoom), and BACK / START.
Installation
- Download and install BioShock1-Android-v0.0.4-experimental.apk on an �rm64-v8a Android 9+ device (GLES 3.2).
- Tap IMPORT ISO in the launcher and select your own legally obtained Xbox 360 World Release BioShock 1 ISO (Title ID 545407D8, Media ID 44E704F7 — no game data is included in the APK).
- Tap START GAME. Use the top-left HUD pills to toggle resolution (360p–1440p), upscale filter (LANCZOS/BILINEAR), or TOUCH: ON/OFF live without restarting.
v0.0.3-experimental - Windows Custom D3D11 Renderer (live resolution, flicker & stutter fixes)
v0.0.3-experimental
Windows custom D3D11 Xenos renderer build of the BioShock 1 native static-recomp
port, built on the ReXGlue v0.11.0 runtime.
⚠️ Experimental. This release introduces the standalone custom D3D11 Xenos
renderer (rexgpu-xenos-custom) for Windows with live no-restart resolution
scaling and major stability, streaming, and rendering fixes. No game data is
included; you must supply your own legally-owned copy of BioShock 1.
Downloads
| Platform | Asset | How to run |
|---|---|---|
| Windows (x64, Custom D3D11 + D3D12 fallback) | bioshock1-windows-v0.0.3-experimental.zip |
Extract, set up C:\bs1game, run run-windows.ps1 |
(For the Android arm64 APK, use v0.0.2-experimental — this release focuses on the Windows custom renderer.)
What's new since v0.0.2-experimental
- Standalone Custom D3D11 Xenos Renderer (
librexgpu-xenos-customd.dll):
Wired as the default Windows GPU backend (--gpu.driver=custom, with
--gpu.driver=d3d12retained as a runtime fallback). - Live No-Restart Internal Resolution Scaling:
Press F1 in-game to cycle360p → 720p → 1080p → 1440p → 2160plive with
zero restart (defaults to1080p). Press F2 to togglelanczos ↔ bilinear
present filtering live, and F4 to edit allgpu.custom.*settings
(resolution preset/scale %, filter, anisotropy, MSAA, FXAA, letterbox, VSync). - Multipass Flickering Fixed:
Fixed D3D11 binding hygiene (ForgetBindings()now unbinds RTVs, PS/VS SRVs,
PS, and GS; explicit stage-bound flags; stoppedEndPresent()from stomping
mid-frame PM4 bindings), eliminating depth-only /discardcheckerboard
flickering on geometry, statues, and banners. - Smooth Scene Streaming & Fast First Boot:
Async FIFO FXC shader compilation (D3DCOMPILE_OPTIMIZATION_LEVEL0+
synchronous disk-cache fast path + non-blocking 3D draw fallback) and fast
64-bit word-swapped texture untiling for compressed DXT/BC surfaces. - Xenos PM4 / State & Color Fixes:
Fixed indexed DMAsourceSelectbit shift ((initiator >> 6) & 3),
DepthClipEnable, dual-face cull skip,RB_STENCILREFMASK_BF,kD24FS8
depth clear decode,vfetch_minislot inheritance,preciseVS position
invariance, and R↔B / 1- & 2-channel texture swizzles. - Kernel Stability Fix (
librexkerneld.dll):
RtlLeaveCriticalSectionwarns instead of aborting on cross-thread release so
guest loading threads do not crash on New Game.
Verified
scripts/verify-all.py: 12/12 PASS.- Standalone zip launch smoke-tested with clean
PATH(all MinGW + ReXGlue DLLs bundled). - In-game rendering, live resolution switching, and flicker/streaming fixes confirmed.
Requirements
- Windows 10/11 x64 with a Direct3D 11 capable GPU.
- Extracted BioShock 1 (Xbox 360) game tree at
C:\bs1game(junction supported, or pass-GameRoot).
Legal
No BioShock assets, ISO, XEX, BIOS, or Microsoft material are included. You must
own a legal copy of the game. See docs/13-LEGAL.md.
v0.0.2-experimental - Windows + Android binaries (dual sticks, F1 resolution toggle)
v0.0.2-experimental
Second experimental build of the BioShock 1 native static-recomp port for
Windows and Android, built from the real ReXGlue v0.11.0 runtime.
⚠️ Experimental. The genuine title screen, intro, main menu and difficulty
select render on-device from the guest's ownVdSwappresent path. The game is
in-game but not fully validated — expect rough edges. No game data is
included; you must supply your own legally-owned ISO.
Downloads
| Platform | Asset | How to run |
|---|---|---|
| Android (arm64-v8a) | bioshock1-android-v0.0.2-experimental.apk |
adb install -r, open app, IMPORT ISO, START GAME |
| Windows (x64, D3D12) | bioshock1-windows-v0.0.2-experimental.zip |
Extract, set up C:\bs1game, run run-windows.ps1 |
What's new since v0.0.1-experimental
- Android: working touch controls. A virtual gamepad feeds the runtime input
system, so on-screen START advances from the title to the main menu. A/B/X/Y
and START are wired; guest profile-save crashes on advancing menus are fixed. - Android: dual-stick layout. Separate MOVE (left) and LOOK (right) floating
sticks for swimming/forward movement and camera look, with larger regions and
higher sensitivity. - Windows: F1 in-game resolution toggle. Cycle internal draw resolution
1x → 2x → 3x → 1x to A/B compare sharpness (title reloads to apply). - Windows: custom renderer upscale. A Lanczos2 guest-output shader replaces
bilinear upscaling for a clear, sharp fullscreen image. Toggle live with no
restart via F2 or the F4 settings menu (gpu.xenos.present_upscale).
Full render-scale changes (F1) still reload the title, as in other ports. - Windows:
run-windows.ps1launcher. 1280x720 native windowed (1:1, sharpest)
by default; use-Fullscreen -Scale 2for a sharp fullscreen image. - Guarded Android-only includes so the Windows MinGW build is clean.
Verified
scripts/verify-all.py: 12/12 PASS.- Title screen, animated intro, menu and difficulty select rendered via real
guest presents (VdSwap2500+ frames), no shader-driver crashes. - Windows exe built with MinGW clang; F1 toggle confirmed live.
Requirements / limitations
- Android: arm64-v8a, Vulkan-capable GPU, Android 9+. Full 492-file game tree
(~4.7 GB) extracted into app-private storage at runtime. - Windows: D3D12-capable GPU. Game tree at
C:\bs1game(junction supported). - Audio/input helpers are relaxed on Android; game data is never in the APK.
- Gameplay beyond the early menus is unverified.
Legal
No BioShock assets, ISO, XEX, BIOS, or Microsoft material are included. The
screenshots in the repository are documentation evidence only. You must own a
legal copy of the game. See docs/13-LEGAL.md.
v0.0.1-experimental - First guest-rendered title screen (Windows + Android)
⚠️ EXPERIMENTAL PRE-RELEASE —v0.0.1-experimental
This is an early proof-of-concept. The genuine BioShock 1 title screen and
intro are verified on both Windows and Android. The game is not yet fully
playable — treat this as a milestone for the recompilation pipeline, not a
finished port.
✅ What works in this release
- Genuine title screen on Windows — rendered by the real ReXGlue v0.11.0
runtime with the D3D12 backend, through guestVdSwappresents.
Evidence:docs/screenshots/host-title.png. - Genuine title screen on Android — rendered by the same real runtime with
the Vulkan backend on arm64-v8a, guest-presented viaVdSwap→
vkQueuePresentKHR. The device stayed alive for minutes at ~25 fps
(2,500+ swaps) with no crashes. Evidence:docs/screenshots/android-title.png,
anddocs/32-GOAL-ANDROID-TITLE.md. - Static recompilation, no emulator/JIT — PPC guest code is translated
ahead-of-time to C++ and compiled natively for the target. - No game data in the APK — the launcher imports your own ISO through the
Android document picker and extracts the XEX and full game tree into
app-private storage at runtime. Nothing proprietary is shipped. - Reproducible pipeline —
tools/pipeline.pyhandles inspect → configure →
build, plus installers for the external toolchains and SDK. - Documentation — 32 detailed docs including the full debugging journal,
with a green verification suite (scripts/verify-all.py: 12/12 PASS).
🚧 What does not work yet
- Gameplay is unverified; expect the title/legal/intro screens and early boot
only. - Audio and input are relaxed for boot in the Android build.
- The SDL touch overlay is always visible; controls are not yet mapped for play.
- Requires a Vulkan-capable arm64 Android device (tested on SM-A366B / Adreno).
🔧 Technical highlights
This release includes patches in patches/ that were required to reach the
title screen:
- SPIR-V correctness — glslang's
createAccessChainused unset internal
state for the result type, producing invalid SPIR-V that crashed the Adreno
compiler. Patched to derive the type from the actual base/offsets. - Presenter connection — the headless SDL bootstrap never delivered the
surface resize event, so presents were silently skipped. Added
App::NotifySurfaceResized()and call it from the JNI bridge. - Allocator stability — a
std::stringfree inPosixThread::SetName
corrupted the host heap on a guest thread; guarded on Android.
📦 Getting started
# 1. Fetch dependencies (not vendored in this repo)
python tools/pipeline.py inspect
python tools/pipeline.py configure
./scripts/install-toolchain.ps1
./scripts/install-rexglue.ps1
# 2. Apply patches/PATCHES.md to third_party/rexglue-git before Android builds
# 3. Windows host launcher
python tools/pipeline.py build-native
build\bs1-real\bioshock1.exe
# 4. Android launcher
python tools/pipeline.py build-apk
adb install -r android\app\build\outputs\apk\debug\app-debug.apkOn Android: tap IMPORT ISO, select your legally-owned BioShock ISO, wait for
extraction, then START GAME.
See the README and docs/00-START-HERE.md
for the full guide.
⚖️ Legal
No game data, ISO, XEX, BIOS, or Microsoft material is included in this release.
The screenshots are documentation evidence, not game assets. You must own a
legal copy of BioShock 1. See docs/13-LEGAL.md.