XR Tracking Diagnostics

OpenXR API layer for recording head tracking data and diagnostics.

What It Does

Records VR headset position/rotation data for tracking quality analysis and comparison between different headsets.

Build

Visual Studio (Recommended)

1. Configure the project:

   .\configure.ps1

2. Open build-x64\xr_tracking_diagnostics.slnx in Visual Studio
3. Select Debug or Release configuration
4. Press Ctrl+Shift+B to build

Command Line

.\build.ps1 -Config Release

Install

Right-click quick_reinstall.ps1 → Run with PowerShell (auto-elevates to Administrator)

Installs to C:\ProgramData\XRTrackingDiag\ and registers with the OpenXR runtime.

Usage

Works with OpenXR applications only (not SteamVR/OpenVR games).

1. Launch an OpenXR app
2. Listen for double beep - confirms layer loaded
3. Press F9 together to start/stop recording
4. High beep = recording started, Low beep = recording stopped

Compatible Apps

• OpenXR native games (Microsoft Flight Simulator, DCS World, Elite Dangerous)
• OpenVR games through OpenComposite

Not Compatible

• Native SteamVR games (Half-Life: Alyx, Beat Saber) - these use OpenVR API, not OpenXR

Output

• Recordings: %USERPROFILE%\Documents\XRTrack
• Logs: %TEMP%\xr_tracking_layer.log

Visualize Recordings

Compare tracking data between headsets:

python tools\visualize.py

Selects CSV files via Windows dialog and opens an interactive HTML report in your browser.

Troubleshooting

Common Issues

• No beep in SteamVR games - those use OpenVR, not OpenXR
• Check logs: notepad $env:TEMP\xr_tracking_layer.log

Uninstall

.\scripts\uninstall.ps1

Building Release Packages

To create a distributable zip file:

.\package-release.ps1 -Config Release

Creates release\XRTrackingDiag-v1.0.0-Release.zip containing:

• DLL and manifest
• Install/uninstall scripts
• Visualization tool
• README

Users can extract and run install.ps1 (as Administrator) to install.