sammwyy/xvalkyrie
GamesExperimental translation layer that runs Xbox One and Series X|S executables natively on 64-bit Windows, aimed at researchers and homebrew developers.
Project intro
XValkyrie is an experimental compatibility layer that lets Xbox One (Durango) and Xbox Series X|S (Scarlett) software run on 64-bit Windows. It is explicitly not a console emulator: both consoles are x86-64 machines running a cut-down Windows, so a title's executable is mapped into a process, its code executes natively, and imports such as d3d12_xs.dll, xgameruntime.dll and kernelx.dll are answered by implementations built on the host's Direct3D, audio and input How it works.
What does need translation is the console-specific parts: the console builds of Direct3D 11 and 12, the GPU machine-code shaders shipped by Series titles, physical memory layout and console system services such as users, saved games and Xbox Live. The project is written in C++20 and is closest in spirit to Wine and Proton.
Status
The layer is early and does not play games through yet. Xbox One titles using Direct3D 11.X and WinRT can reach menus and scenes with a gamepad, but saved games, audio decoding and Xbox Live are stubs or missing. For Xbox Series X|S, all 40 public GDK samples that build for Series render their frames; retail titles start, create their device and present frames, and in one title 1966 of the 2004 shaders created in the first four minutes translate and compile, but the resulting picture is not correct yet status. The per-function implementation detail lives in docs/STATUS.md and plans in ROADMAP.md.
Build
You need Windows 10 or 11 x64, Visual Studio 2022 with the "Desktop development with C++" workload, CMake 3.25 or later and Python 3. CMake fetches dependencies on the first configure. From a command prompt in the repository:
build.cmd --test
This produces xvalkyrie.exe and xvboot.exe in build\win\Release. Optional arguments include Debug for a debug build, --vulkan to additionally build Direct3D 11 on Vulkan (requires Meson and glslang), --target NAME and --reconfigure; the JOBS environment variable sets the number of parallel compilations Building. Place dxcompiler.dll and dxil.dll next to xvalkyrie.exe or in a Windows SDK for fast shader compilation; otherwise the system compiler is used and large shaders take minutes.
Quick start
Launch xvalkyrie to open the game library window, then add folders via Options > Game Libraries so they are scanned for titles. A title is either an executable or the folder of an unpacked title containing MicrosoftGame.config or AppxManifest.xml; packaged .xvc files are listed but cannot be opened because XValkyrie decrypts nothing. Select a title to start it, or launch it from the command line:
xvalkyrie [FILE|FOLDER]
xvboot exec TITLE [--allow-missing] [--trace] [--mute] [--backend d3d11|vulkan]
In the window, Options > Input binds the gamepad to keys or to a host gamepad, Options > Graphics selects the backend and F11 behavior, and Options > Console sets the signed-in user and optional system storage. Settings are stored in %APPDATA%\xvalkyrie\config.ini, with one log file per session and title under logs. If a title does not use a package, use xvboot inspect, assess, bind, map or properties to inspect it without running it; these print JSON reports Usage.
Constraints
- Windows x64 only; the project depends on Windows for the parts of the console system that are Windows, so there is no Linux build.
- Experimental state: expect crashes and incorrect graphics, not finished gameplay. Xbox One support stops at menus and scenes; Series retail titles are not visually correct.
xvboot execruns the title's code inside its own process with no sandbox, so only run binaries you trust.- No games, keys, firmware or SDK files are bundled or linked, and retail packages cannot be decrypted; supply your own unpacked titles.
- Licensed under GPL-3.0; derivative work must stay under the same license and keep notices. Third-party components keep their own licenses license.
HotRepo's take
XValkyrie appeared on HotRepo's new-project board on 2026-11-22 at rank 113 on the C++ list, with 12 stars gained over a roughly five-hour observed window; the star curve rose from 101 to 113 during that afternoon. There are no all-language daily rank records and no Hacker News discussion to draw on. The numbers support only that the repository attracted modest early attention in a short window, not that the compatibility layer is mature: its own status section says retail Series titles still render incorrectly, so the listing reflects interest in the approach rather than a usable player.
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
- R0Y00/Xbox2WindowsXbox Series X|S static recompilation research for x64 Windows, using GTA VI as a case study.
- Freminet/ScarlettXAn experimental high-level emulator that runs legally obtained Xbox Series X|S GDK titles on Windows x64.
- ivall/xclRun Xbox Series X|S game files natively on Windows without CPU emulation, for technical users experimenting with console compatibility.
- Vita3K/Vita3KAn experimental emulator that runs PlayStation Vita homebrew and commercial games on Windows, Linux, macOS and Android.
- cemu-project/CemuRun most Wii U games and homebrew on 64-bit Windows, Linux and macOS with an open-source emulator.