Freminet/ScarlettX
GamesAn experimental high-level emulator that runs legally obtained Xbox Series X|S GDK titles on Windows x64.
What It Is
ScarlettX targets Xbox Series X|S (Scarlett / Gen9 Game Core) software on Windows x64. Because Gen9 executables are native x86-64 PE32+ binaries built against Microsoft's GDK, the project emulates the operating layer underneath them: xgameruntime.dll, the TaskQueue/Async model, d3d12_xs graphics, the DirectStorage/XVD storage path, GameInput, XAudio2/AcpHal, and the ray-tracing stack, rather than recompiling CPU code. It is aimed at people studying console runtime emulation and at developers testing GDK title bring-up.
The repository states it ships no Microsoft binaries, keys, firmware, or game assets, and that automated tests run against synthetic PE titles built from source. One commercial title, Concept Destruction, is used as an external bring-up target.
Architecture and Coverage
Subsystems are tracked as HLE API implementations: PE64 loader and auto-stubs, GDK runtime, d3d12_xs with root signatures and PSOs, DXR/BVH, DirectStorage and unencrypted XVD mounting, GameInput, XGameSave, XAudio2/AcpHal, and middleware shims such as Bink2 and FidelityFX. The published status puts overall emulator coverage at 64.4% of 404 tracked functions and Concept Destruction at 87% of its bring-up milestones; graphics, storage, and task queue layers are the most complete, while Xbox unified memory, KernelX, RDNA2 shader lifting, retail XVC/XVD decryption, and live Xbox services remain at 0%.
Building and Testing
Building requires Windows x86-64 with CMake 3.20+, Ninja, a C++20 compiler (MinGW-w64 GCC 13+ or MSVC 2022), and the Windows D3D12 runtime with WARP. The documented flow is:
cmake -S . -B build -G Ninja -DCMAKE_BUILD_TYPE=Release
cmake --build build
ctest --test-dir build --output-on-failure
Synthetic test packages can then be inspected and booted:
./build/scarlettx inspect build/packages/hello_scarlett
./build/scarlettx boot build/packages/hello_scarlett --headless --frames 3
./build/scarlettx boot build/packages/rt_showcase --headless --frames 2 --rt-dump rt_frame.ppm
Running a Real Title
From the directory containing scarlettx.exe and the shim DLLs, boot an extracted package's Mount directory with --in-process (the real-title path) and optionally --gpu or --warp, --stats, --trace. Keyboard controls map arrows/WASD to the pads, Enter/Space to A, Escape/Backspace to B, with an XInput controller also accepted. Stop the emulator with Ctrl+C; the window title bar does not close it. Saves go to %TEMP%\scarlettx_saves by default, configurable through SCARLETTX_SAVE_ROOT. The README documents one commercial title running in-game on a hardware GPU at roughly 110–140 fps with audio and persisted progress.
Constraints
- Real title support covers only the API slots one title uses; other titles will encounter unimplemented or unnamed Xbox COM slots.
- Fullscreen does not work: Alt+Enter freezes the picture until toggled again, and frame pacing is not applied, so frame rates are uncapped.
- Guest texture uploads reach the host one frame late; a dedicated test fails on this.
- Child-process mode relies on
PATHto find shims and can pick up the system copy ofxgameruntime.dll, causing0xC0000139exits;--in-processavoids this, and two boot tests fail in child mode. - Bink2, FidelityFX, DirectStorage decompression, XMA2, HTTP/XCurl use deterministic offline shims; passing synthetic tests does not imply retail title execution.
- Rumble state is stored but not forwarded to the host controller. No license is declared in the repository.
HotRepo's take
ScarlettX appeared in HotRepo's C++ new-project list on 2026-11-22, with 105 stars and 14 forks and 5 stars gained over the recorded one-hour window; best overall daily rank is not recorded. On a technical level the interesting part is the explicit coverage table and the three failing tests, which mark the boundary between synthetic emulation and real-title parity; the gap between a 64.4% function count and full Xbox OS behavior (unified memory, KernelX, retail package crypto) is where most of the remaining work sits.
Written by AI from the project's public information and HotRepo's records, updated . The project's own docs are the source of truth.
You might also like
- zortos293/LichiiAn experimental open-source Nintendo Switch and Switch 2 emulator for Windows, Linux and macOS, aimed at players testing game compatibility.
- zortos293/EglantineAn experimental, open-source Nintendo Switch and Switch 2 emulator written in C++ for desktop play and compatibility testing.
- InoriRus/KytyAn early-stage C++ emulator that runs some PS4 games and PS5 homebrew on Windows 10 x64.
- omonkeyz/xbox-emulatorA Rust Xbox Series X|S runtime experiment that runs decrypted game dumps as Windows processes, tracking compatibility progress.
- Djihads80/EglantineAn experimental, open-source Nintendo Switch 2 emulator in C++ for Windows, Linux and macOS, aimed at players testing game compatibility.