kneesox/ReVision-VPE-VRCFT-Module
Watch
1
0
Fork
You've already forked ReVision-VPE-VRCFT-Module
 0
mirror of https://github.com/ShiroBlank/ReVision-VPE-VRCFT-Module.git synced 2026-09-10 13:18:16 +00:00
Code Issues Projects Releases Packages Wiki Activity
ReVision Vive Pro Eye module for VRCFaceTracking
2 commits 1 branch 1 tag 43 KiB
  • C# 100%
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Shiro f53eb8347a
 Add files via upload
2026-08-23 14:14:21 +01:00
AssemblyInfo.cs Add files via upload 2026-08-23 14:14:21 +01:00
EyeOpennessEstimator.cs Add files via upload 2026-08-23 14:14:21 +01:00
README.md Add files via upload 2026-08-23 14:13:14 +01:00
ReVisionProtocol.cs Add files via upload 2026-08-23 14:14:21 +01:00
ReVisionViveProEye.csproj Add files via upload 2026-08-23 14:14:21 +01:00
ReVisionViveProEyeModule.cs Add files via upload 2026-08-23 14:14:21 +01:00

README.md

ReVision Vive Pro Eye module for VRCFaceTracking

Built specifically against VRCFaceTracking 5.4.5.0 on .NET 10.

Install

Copy ReVisionViveProEyeExtTrackingModule.dll into:

~/.config/VRCFaceTracking/CustomLibs/

Restart VRCFaceTracking after copying the file.

Run

  1. Start ReVision:

    cd ~/ReVision-v2
sudo dotnet ReVision/bin/Debug/net10.0/ReVision.dll

  2. Start VRCFaceTracking.

  3. Confirm that ReVision Vive Pro Eye appears as the eye module and enable tracking.

  4. Start VRChat and enable OSC.

Do not run probe_real.exe at the same time. The diagnostic probe and this module use the same single-client ReVision bridge.

Data mapping

  • Per-eye normalized gaze direction is sent to VRCFT with the X axis flipped, matching VRCFT's official SRanipal module.
  • The raw eye-camera images are converted into separate continuous left/right openness values. Normal open is near 1, a half-squint is approximately 0.35–0.5, and fully closed is near 0.
  • The original blink bit remains a fallback if an eye image is unavailable.
  • Valid pupil diameter is sent in millimeters.
  • Invalid gaze samples leave the last valid gaze unchanged.

The eyelid model in this build is calibrated for the headset's normal wearing position and includes lifted-position examples so small fit shifts remain tolerated. It runs inside the module and does not require Wine, SRanipal, or a separate helper program.

The module connects to 127.0.0.1:38547 by default. Advanced overrides are available through the REVISION_VRCFT_HOST and REVISION_VRCFT_PORT environment variables.