How r0y00/xbox2windows works
Xbox2Windows is a research toolkit for translating and validating selected Xbox Scarlett CPU and GPU behavior on Windows, alongside desktop compatibility shims. The main workflows begin with inspecting PE/resources or shader code, then produce a bounded translation or replay and compare results against references. Separate branches cover CPU lifting, shader translation and GPU resource analysis, and Windows memory/GPU compatibility. The graph reflects README-described capabilities even where implementation details were not sampled; those broader links are omitted when no relationship is evidenced.
Main entry points: resource_inventory.py Resource inventory · cpu_leaf_aot.py Leaf lifting · pixel_aot.py Pixel translation · era_title_gpu.cpp Title GPU memory
Components 25
Package analysis
- PE inventory
tools/pe_inventory.py - Resource inventory
tools/resource_inventory.py - Call evidence
tools/call_evidence.py - Shader extraction
tools/extract_shaders.py
CPU translation
- CPU ranges
tools/cpu_ranges.py - Leaf lifting
tools/cpu_leaf_aot.py - Call lifting
tools/cpu_call_aot.py - Chained lifting
tools/cpu_chained_aot.py - Switch lifting
tools/cpu_switch_aot.py - FidelityFX query
tools/ffx_version_query.py - x87 lowering
tools/x87_lower.py
GPU and shaders
- Shader scan
tools/scan_unsupported_shaders.py - Pixel translation
tools/pixel_aot.py - Coverage translation
tools/sampled_coverage_aot.py - Mesh translation
tools/mesh_entry_aot.py - DXIL retargeting
tools/dxil_retarget.py - FSR dispatch
tools/ffx_dispatch_aot.py - BC7 blocks
tools/bc7_blocks.py
Windows compatibility
- Title GPU memory
src/era_title_gpu.cpp - GPU heap aliases
src/era_gpu_alias.cpp - GPU address map
src/era_title_va.cpp - Virtual memory query
src/era_query.cpp - XMem shim
src/xmem_shim.cpp - Windows heap
src/era_heap.cpp
Other components
- Researcher
Connections 34
- Researcher → PE inventory: inspects PE
README.md - Researcher → Resource inventory: inspects resources
README.md - Researcher → Leaf lifting: translates functions
README.md - Researcher → Pixel translation: translates shaders
README.md - Researcher → Shader extraction: extracts shaders
README.md - Call evidence → PE inventory: uses inventory
tools/call_evidence.py - Call evidence → Resource inventory: uses inventory
tools/call_evidence.py - Shader extraction → Resource inventory: uses inventory
tools/extract_shaders.py - Leaf lifting → CPU ranges: reads ranges
tools/cpu_leaf_aot.py - Call lifting → Leaf lifting: uses lifting
tools/cpu_call_aot.py - Chained lifting → Leaf lifting: uses lifting
tools/cpu_chained_aot.py - Chained lifting → CPU ranges: reads ranges
tools/cpu_chained_aot.py - Switch lifting → Leaf lifting: uses lifting
tools/cpu_switch_aot.py - Switch lifting → CPU ranges: reads ranges
tools/cpu_switch_aot.py - FidelityFX query → Leaf lifting: uses lifting
tools/ffx_version_query.py - FidelityFX query → CPU ranges: reads ranges
tools/ffx_version_query.py - FidelityFX query → x87 lowering: uses lowering
tools/ffx_version_query.py - Shader scan → Resource inventory: uses inventory
tools/scan_unsupported_shaders.py - Shader scan → Pixel translation: uses translator
tools/scan_unsupported_shaders.py - Pixel translation → Resource inventory: uses inventory
tools/pixel_aot.py - Coverage translation → Pixel translation: uses decoder
tools/sampled_coverage_aot.py - Coverage translation → Resource inventory: uses inventory
tools/sampled_coverage_aot.py - Mesh translation → Pixel translation: uses decoder
tools/mesh_entry_aot.py - Mesh translation → Resource inventory: uses inventory
tools/mesh_entry_aot.py - DXIL retargeting → Resource inventory: uses inventory
tools/dxil_retarget.py - DXIL retargeting → Call evidence: uses evidence
tools/dxil_retarget.py - DXIL retargeting → Shader scan: uses probes
tools/dxil_retarget.py - FSR dispatch → Pixel translation: uses translator
tools/ffx_dispatch_aot.py - Title GPU memory → GPU heap aliases: opens aliases
src/era_title_gpu.cpp - Title GPU memory → GPU address map: maps addresses
- Title GPU memory → Virtual memory query: registers regions
src/era_title_gpu.cpp - XMem shim → Windows heap: uses heap
src/xmem_shim.cpp - XMem shim → Virtual memory query: uses query
src/xmem_shim.cpp - XMem shim → Title GPU memory: routes graphics memory