StegraOS

Tested devices

Hardware testing

Model	Status
Nintendo Switch Lite	Tested
Nintendo Switch OLED	Tested
Nintendo Switch V2	Not tested separately

These are project test results, not a guarantee of stability for every game or configuration.

Graphics paths

Simplified diagrams

Steam interface

Working configuration: 1280 × 720, Gamescope Composer mode 3.

Steam / CEFANGLE · OpenGL
Mesa ZinkOpenGL → Vulkan
NVIDIA TegraGPU rendering
GamescopeGPU buffers · composition
Switch displayTegra scanout

The validated CEF frame path removes CPU pixel readback and texture upload. Frames use GPU buffers and synchronization; GPU copies and CPU work still remain.

Windows games

Tested with Half-Life 2: Deathmatch using FEX and Box64.

Windows x64Game · FEX / Box64
Proton / WineDirect3D → DXVK
NVIDIA VulkanGPU rendering
GamescopeFROG / Wayland
Switch displayTegra scanout

FEX and Box64 translate CPU code. HL2DM uses D3D9Ex → DXVK-Sarek → Vulkan.

Linux games

Native Linux versions of Super Meat Boy and FEZ using Box64.

Linux x86_64SMB · FEZ
Box64CPU code translation
Native ARM graphicsGL / Vulkan · NVIDIA GPU
GamescopeWayland / Xwayland
Switch displayTegra scanout

The game uses native ARM graphics libraries. Super Meat Boy was tested with SDL and direct Wayland output; FEZ uses MonoKickstart and FNA. These Linux versions do not require Proton.

Core stack

Switchroot / L4T · NVIDIA Tegra · Mesa Zink · Wayland / Xwayland · Gamescope with a Tegra backend

Current status

Working features

720p Steam UI rendered through Zink instead of llvmpipe.
Touchscreen, USB mouse and keyboard, and gamepad, with orientation and input routing fixes.
Super Meat Boy, FEZ and HL2DM launch in tested configurations.
Stegra Control panel: supported CPU/GPU clocks, monitoring and ZRAM configuration for the next boot.
Hold Capture for about three seconds to restart the Steam session.
Optional unloading of steamwebhelper while a game is running.

Known limitations

GPU/consumer faults, freezes and game exit issues remain.
Compatibility and performance vary by game. There is no general compatibility guarantee.
Restoring Steam UI after unloading webhelper in Windows games still needs work.
The session restart shortcut cannot recover a frozen kernel.

Source code and research

GitHub · zodiakborodin98 ↗

gamescope-tegra

Gamescope for Tegra, graphics stack changes and build scripts.

Compositor

tegra-lcd-backend

A separate backend for output to the built-in Tegra display.

Display

System integration, session configuration and installation image preparation.

System

steamos-tegra-research

Reports on experiments, fixes and remaining blockers.

Research

Downloads

StegraOS image

Installation through Hekate. A download link will be added after image validation.

Coming soon

Installation guide and SHA256

Installation steps and checksums for the published release.