https://github.com/ghostiam/vrcfttobiiadvanced
Tobii Advanced Eye Tracking Module for VRCFaceTracking (Supports any HMD that has Tobii tracking, for example "HP Reverb G2 Omnicept" or "Pimax Crystal")
https://github.com/ghostiam/vrcfttobiiadvanced
eye-tracking eyetracking pimax pimax-crystal tobii tobii-eye-tracker vr vrcft vrchat vrchat-osc
Last synced: 29 days ago
JSON representation
Tobii Advanced Eye Tracking Module for VRCFaceTracking (Supports any HMD that has Tobii tracking, for example "HP Reverb G2 Omnicept" or "Pimax Crystal")
- Host: GitHub
- URL: https://github.com/ghostiam/vrcfttobiiadvanced
- Owner: ghostiam
- License: mit
- Created: 2023-12-23T11:10:42.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-20T12:30:36.000Z (about 1 month ago)
- Last Synced: 2025-05-04T17:42:24.698Z (29 days ago)
- Topics: eye-tracking, eyetracking, pimax, pimax-crystal, tobii, tobii-eye-tracker, vr, vrcft, vrchat, vrchat-osc
- Language: C#
- Homepage:
- Size: 1.17 MB
- Stars: 7
- Watchers: 2
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## Tobii Advanced Eye Tracking Module for VRCFaceTracking
A module for working with Tobii Eye Tracking in VRCFaceTracking.
### Supported devices
- HP Reverb G2 Omnicept Edition.
- Pimax Crystal.
- and more.
### Usage
- Download and install [VRCFaceTracking](https://github.com/benaclejames/VRCFaceTracking)
- Download the archive with the module from [release](https://github.com/ghostiam/VRCFTTobiiAdvanced/releases/latest)
- Run VRCFaceTracking
- Go to the "Module Registry" tab
- Click "+ Install Module From .zip"
- Select the downloaded archive
- Done!
### How to use the "advanced" mode.
> [!IMPORTANT]
> You must have a file with a valid license, otherwise the module will not work in "advanced" mode!\
> Or you can use the workaround: [Broken Eye](https://github.com/ghostiam/BrokenEye)
By default, the module is loaded without a license, which allows you to use it
to track combined gaze direction and eye opening/closing.
The "Advanced" mode allows you to track the gaze direction for
each eye separately, as well as get information about the pupil diameter.
For this, you must have a valid license, in which is indicated
```
"featureGroup": "professional"
```
(you can see an example in the file [license.example.json](license.example.json))
It needs to be placed in the module folder
```
C:\Users\\AppData\Roaming\VRCFaceTracking\CustomLibs\324b3cd5-5e64-4f3f-b056-12340badc0de
# Or paste into the address bar of the explorer to open the folder
%APPDATA%\VRCFaceTracking\CustomLibs\324b3cd5-5e64-4f3f-b056-12340badc0de
```
under the name `license.json`
After launching VRCFaceTracking, make sure that the module has loaded your license, it should be in the "Output" tab:
```
...
[TobiiAdvanced] Information: Loading license...
[TobiiAdvanced] Information: Creating device with license.
[TobiiAdvanced] Information: Connected to platform module with build version ""
[TobiiAdvanced] Information: Subscribe to advanced data.
...
```
If instead you see:
```
[TobiiAdvanced] Information: No license found in
```
It means the license was not found, check the path and file name.
And if you see:
```
...
[TobiiAdvanced] Warning: License validation failed: TOBII_LICENSE_VALIDATION_RESULT_TAMPERED
...
```
It means you are using an invalid license, check its content.
### How to get a license for "advanced" mode.
Most likely you can only wait until the manufacturer of the device you are using gets a license from Tobii.
### How to use the "advanced" mode without a license.
There is a workaround that will allow you to obtain data on the direction of gaze for each eye separately, the diameter
of the pupil, and even receive images from cameras! And all this without a “professional” license!
The software is called [Broken Eye](https://github.com/ghostiam/BrokenEye) and can be downloaded
[here](https://github.com/ghostiam/BrokenEye/releases/latest).