OXRSys Runtime is an unofficial OpenXR runtime that started on macOS and is being moved toward a measured cross-platform shape. The repository includes the shared runtime, Apple frontends, Qt frontends, and an Android VR streaming client for Quest/Pico-class headsets.

OXRSys is independent software. It is not affiliated with, endorsed by, sponsored by, or approved by The Khronos Group, Meta, Apple, LunarG, or the owners of the platforms, SDKs, runtimes, and trademarks referenced by this project.

The Android VR client can be used over WiFi or USB. The USB path is the best way to experiment with the runtime because it gives the lowest latency. Install adb first.

OXRSys Home exists as a native Apple app and a Qt app. The Apple app owns the macOS direct-distribution workflow. The Qt app is Linux-first and also keeps its launcher, transport readiness, custom ADB selection, and simulator window code portable for macOS and Windows. The macOS package helper builds the runtime and Home app into one local folder; the distribution helper signs that package and can submit the archive for notarization.

Current Status: This project is in early development and is not yet production-ready.

• macOS Support: Due to non-standard OpenXR implementation on macOS, specific workarounds are required. OXRSys Home can launch configured apps with XR_RUNTIME_JSON; command-line launches remain useful for debugging. Unity projects should use the net.demonixis.oxrsys-unity Package Manager package under scripts/unity/.
• Meta Quest Integration: The interface is currently minimal; the app displays a blue screen during standby and a green screen during loading.

Expect frequent crashes and bugs. Contributions are welcome through bug reports, feature requests, and pull requests.

This project uses AI-generated code and documentation. We appreciate professional cooperation regarding this approach.

• macOS 13 or later for Apple frontends and the Metal runtime path
• Linux with Vulkan, FFmpeg development libraries, pkg-config, and Qt 6 for the Linux runtime and Qt frontends
• C++20
• CMake with FetchContent
• Ninja
• OpenXR SDK headers and loader
• Metal
• Vulkan headers for interop paths
• Android SDK, Android NDK, and Java 17 for the Android client

• macOS: Metal rendering, release-time Metal streaming snapshots, core runtime flow, Vulkan interop, typed graphics/frame plumbing, and loader-backed runtime tests are in place.
• Linux: Vulkan runtime scaffolding and an FFmpeg encoder path are wired; real Vulkan image readback is still the main remaining Linux video gap.
• Windows: the runtime backend remains scaffold-only, while shared platform, config, status, and socket helpers are being kept portable.
• XR_EXT_conformance_automation, XR_EXT_hand_tracking, XR_EXT_hand_interaction, and XR_EXT_debug_utils are implemented.
• The Android VR client feeds real Quest/PICO hand joints into the runtime, gates controller poses and actions with explicit active flags, keeps hand-interaction bindings available alongside active controllers with controller-first priority, supports WiFi UDP and reconnecting USB ADB reverse TCP streaming, matches per-frame render poses for smoother headset reprojection, exposes a first-pass XR_FB_foveation path when supported by the headset, and can request a build-configured display refresh rate.
• The visionOS viewer uses a minimal floating search window, then enters immersive VR automatically once the stream connects and sends head pose, hand joints, and first-pass tracked accessory controller data back to the runtime when available.
• OXRSys Home is now a direct-distribution launcher and runtime selector for compatible apps such as Godot and Unity, with a main-window runtime activity summary, autosaved streaming settings up to the shared 200 Mbps runtime cap, bounded Quest logcat capture setup, runtime log reveal actions, transport readiness controls, per-app custom ADB path selection, and optional Developer simulator workflows. Qt Home keeps slow WiFi/ADB readiness work off the UI thread. The Qt Home simulator opens in a dedicated window, uses decoded video as the interaction surface when FFmpeg is available, and keeps tracking-only fallback visible when it is not.
• As of March 17, 2026, the pinned non-interactive OpenXR-CTS baseline is green locally: 63 passed, 36 skipped, 0 failed.

• Install
• Changes
• Build and versioning
• Architecture
• Protocol
• Simulator
• Quest
• macOS Home
• Qt Home
• iOS Viewer
• Vision OS
• Testing And Conformance
• Licensing
• Scripts

Contributions from humans and LLM-assisted workflows are welcome. Keep changes small, tested, and documented: if behavior, architecture, build steps, or platform support changes, update the relevant files in docs/ and AGENTS.md in the same patch.

Before considering a change ready, run the build and tests for the affected platform. If you touch the Android client, also run the Android build. If you touch runtime API or conformance-sensitive behavior, run the CTS lane when practical.

The project is licensed under MPL-2.0. Third-party SDKs, tools, platform runtimes, and OpenXR/Khronos components keep their own licenses and terms; see Licensing.