Home

WKOpenVR

Umbrella SteamVR overlay + driver. One binary (WKOpenVR.exe) and one driver DLL (driver_wkopenvr.dll) host four feature modules. Each module can be toggled on or off via a marker flag file the overlay's Modules tab manages.

Modules

• Calibration -- align lighthouse-tracked trackers with a non-lighthouse HMD. (deep-dive)
• Smoothing -- finger-curl smoothing and per-tracker pose-prediction control for Valve Index Knuckles. (deep-dive)
• InputHealth -- drift and degradation detection for buttons / axes / fingers, with learned compensation. (deep-dive)
• FaceTracking -- face and eye tracking integration with a C# .NET 10 host sidecar. (deep-dive)

Reference

• Architecture -- shared driver DLL, module composition, feature flags, marker files.
• Build -- toolchain prerequisites, CMake invocation, host opt-out switch.
• Protocol -- named pipes, shared-memory rings, Protocol.h v15 reference, version-bump discipline.
• Release process -- how release.yml produces the umbrella zip and four per-feature mirror zips, how the mirrors get pushed.
• Changelog -- auto-appended from conventional-commit subjects; tagged sections promoted on release.

Source and mirrors

• Source of truth: WKOpenVR (this repo).
• Per-feature release mirrors, each shipping the umbrella zip with one enable_<feature>.flag pre-dropped:
  • WKOpenVR-SpaceCalibrator
  • WKOpenVR-Smoothing
  • WKOpenVR-InputHealth
  • WKOpenVR-VRCFT