How omonkeyz/xbox-emulator works
TomBox is an Xbox Series X|S compatibility runtime: it runs already-decrypted game builds as Windows processes while reimplementing console-specific platform APIs. The main path is a game process loading compatibility libraries, which provide Xbox system/GDK behavior and Xbox-flavored graphics and audio; shader translation supports rendering. The README also documents online login and title progress, while the tree shows online-service implementations. Edges are limited to README statements and source-index references; unsampled implementation details are not inferred.
Main entry points: routes_rt.rs DLL routing and hooks · xcrd2_storage.rs Console storage API · device_wrap.rs Xbox D3D12 runtime · engine.rs XAudio engine
Components 15
Runtime compatibility
- Windows process
- DLL routing and hooks
crates/compat/compat-common/src/os_host/routes_rt.rs - Host route selection
crates/compat/compat-common/src/os_host/routes.rs - Image patching
crates/compat/compat-common/src/os_host/patch.rs - GDK file services
crates/compat/compat-common/src/gdk/fs.rs - Console storage API
crates/compat/xcrdapi/src/xcrd2_storage.rs - Storage core
crates/compat/xcrdapi/src/xcrd_core.rs - Storage adapter
crates/compat/xcrdapi/src/xcrd_a.rs
Graphics and shaders
- Xbox D3D12 runtime
crates/compat/d3d12_xs/src/device_wrap.rs - RDNA2 to HLSL
crates/tombox-xshader/src/hlsl.rs
Media
- XAudio engine
crates/compat/xaudio2_9/src/engine.rs - XMA voice support
crates/compat/xaudio2_9/src/xma_voice.rs
Online services
- Title online APIs
crates/compat/compat-common/src/online
Other components
- Decrypted game
- Online services
Connections 13
- Decrypted game → Windows process: runs as
README.md - Windows process → DLL routing and hooks: loads through
- DLL routing and hooks → Host route selection: consults routes
crates/compat/compat-common/src/os_host/routes_rt.rs - DLL routing and hooks → Image patching: uses hooks
crates/compat/compat-common/src/os_host/routes_rt.rs - GDK file services → DLL routing and hooks: uses routing
crates/compat/compat-common/src/gdk/fs.rs - Console storage API → Storage adapter: uses adapter
crates/compat/xcrdapi/src/xcrd2_storage.rs - Console storage API → Storage core: uses core
crates/compat/xcrdapi/src/xcrd2_storage.rs - Windows process → Xbox D3D12 runtime: uses console graphics
README.md - Xbox D3D12 runtime → RDNA2 to HLSL: uses translated shaders
- Windows process → XAudio engine: uses audio APIs
- XAudio engine → XMA voice support: dispatches XMA voices
crates/compat/xaudio2_9/src/engine.rs - Windows process → Title online APIs: uses title services
- Title online APIs → Online services: communicates with