vr-tracker-overlay

An OpenXR overlay to visualize tracked devices. Useful for debugging or double checking that everything is calibrated properly.

Important

The initial "proof of concept" for this project was mostly written by a LLM as a single main.cpp.
It has been 'rewritten' (and will continue to be written) without any LLM assistance and is purely the work of a human (me).

here are some cool images showing off the overlay, in case you were curious

Usage

Launch arguments

Launch Argumant	Description	type
--show-floor-grid	Show a grid at the floor level	flag
--show-device-labels	Show text labels to identify devices	flag
--gizmo-line-thickness	Set the line thickness of the gizmos	uint

Installation

More installation methods to come, if the community desires them...

Linux binary

Download the latest release and run it

Nix

With nix run

nix run git+https://git.insberr.com/insberr/vr-tracker-overlay

Or add to your flake inputs

vr-tracker-overlay.url = "git+https://git.insberr.com/insberr/vr-tracker-overlay";

Development

Clone the repository and submodules

git clone --recurse-submodules https://git.insberr.com/insberr/vr-tracker-overlay.git

Note

If you forgot to clone with --recurse-submodules, you can fetch submodules by:

cd vr-tracker-overlay
git submodule init
git submodule update

Build and run

cd vr-tracker-overlay
cmake -DCMAKE_BUILD_TYPE=Debug -DCMAKE_MAKE_PROGRAM=ninja -G Ninja -S ./ -B ./cmake-build-debug
cmake --build ./cmake-build-debug --target vr-tracker-overlay -j 30
./cmake-build-debug/vr-tracker-overlay --show-floor-grid --show-device-labels --gizmo-line-thickness 5