TuxBox (formerly TomBox) is an experimental Xbox Series X|S compatibility runtime for x86-64 PCs. Linux with Proton is the primary development platform. The same compatibility DLLs also run on Windows. Game code runs on the host CPU. TuxBox translates Xbox Direct3D 12 calls and precompiled RDNA2 shaders to PC Direct3D 12. On Linux, Proton’s vkd3d-proton backend submits that work to Vulkan.
| Area | Verified result |
|---|---|
| Graphics | Coin Run draws 2D and 3D scenes under Proton. GPU readback checks geometry, textures, depth and selected retail compute shaders. |
| Input and audio | Linux virtual gamepads verify GameInput polling, history, hotplug and rumble. Stereo loopback measures simultaneous XAudio2 PCM voices and panning. |
| Retail titles | One recorded Windows build of Fortnite reached the lobby with rendering defects and silent audio. Gameplay and retail startup on Proton remain unverified. Retail case study |
Microsoft’s public GDK samples guide platform testing. The audit compares specific calls, distinguishes desktop from console builds, and records reproducible passes and failures. GDK sample audit
Reading the map. Each import square represents one DLL and symbol across the recorded title and 16 Scarlett libraries. Green requires a behavior check for that pair. An observed import or resolved export with unverified behavior is amber. Missing exports are grey. Hover for the callers and evidence. Direct3D green counts implemented or forwarded slots. RDNA2 green requires successful translation in the full retail shader audits. For comparisons found only in the Scarlett PS09 cache, every containing shader must pass GPU readback. Compatibility matrix · Known limitations
Coin Run uses generated assets and needs no game dump. On x86-64 Linux, use Cargo and Python 3 to run the native parser and shader tests. To play Coin Run, install Proton Experimental in Steam and use a Vulkan-capable GPU, the Rust x86_64-pc-windows-msvc target, cargo-xwin, clang-cl and lld-link.
./tuxbox test
tools/homebrew/build-clear.sh
./tuxbox homebrew --3d-test
./tuxbox homebrew --3dThe launcher searches Steam’s registered libraries for Proton Experimental. Set PROTON to the path of the Proton executable for a custom installation. Collect both coins with WASD, the D-pad or the left stick. R or Menu restarts the board. Q or Escape quits. The test guide covers GPU readback, GameInput and audio loopback. Coin Run test guide
Use ./tuxbox run /path/to/game.exe for an executable already prepared with its required DLLs and assets. The launcher sets the working directory to the executable’s directory and forwards its arguments and exit status. Launch and prefix settings
The runtime targets Windows 10/11 x64 with a Direct3D 12 GPU, Microsoft Gaming Services, Rust and the Windows SDK. The title guide covers the static CRT build, DLL placement, drive mapping, configuration and logs. Windows build and launch guide
The development log records retail test results. The Linux research tools work with the included fixtures. Development log · Linux research tools · Architecture · Design decisions · Xbox platform research · Fortnite analysis · Progress data and generator
TuxBox is independent interoperability research for authorised, already-decrypted binaries. Bring your own game files. Package decryption, key extraction, console-security bypasses and anti-cheat changes are outside the project’s scope. Shims using the in-process network guard default to offline. The launcher itself can also run ordinary programs that use no shim. Project testing uses local substitutes or a private server. The local user and store provide no Xbox Live account or entitlements. Xbox is a Microsoft trademark. TuxBox is unaffiliated with Microsoft and game publishers.