← Back
Fwooffy

Fwooffy/Qpro-Enhanced-FT-Wireless

Enables tongue tracking, eye convergence and pupil dilation tracking on a rooted Quest Pro over wifi

View on GitHub ↗
Stars
82
Forks
1
Watchers
82
Open issues
7
Contributors
2
Language
Python
License
MIT License
Default branch
main
Created Sep 24, 2026Updated Oct 1, 2026

Star growth

Today—
This week—
This month—

Star history will appear here once this repo has been tracked for a couple of days.

README

QproFaceTracking V2.1.2

A Windows Hub for enhanced face tracking on a rooted Meta Quest Pro, based on Qpro-Enhanced-FT by n0tmast3r. It supports Virtual Desktop or Steam Link, USB or wireless ADB, tongue tracking with NVIDIA CUDA, experimental AMD ROCm support, and CPU fallback. Optional features include independent eye gaze, relative pupil animation, individual cheek puff and suck, and eyebrow sensitivity.

V2.1.2 is being prepared as a release candidate. See the V2.1.2 release notes for the changes and experimental features. The Releases page remains the place to download published builds.

Download the runnable ZIP from Releases. Extract it before opening QproFaceTracking.exe. GitHub's automatic source ZIP does not include the Hub executable or packaged models and tools.

The latest VRCFaceTracking from Steam is required. If you used a Qpro version before V2.0, record and train a new tongue model. Working V2.0 through V2.0.2 models can be exported and imported into V2.1.2 through Model manager.

The developer v8 tongue model remains the default. Mustachio is a separate, opt-in, highly experimental extension of v8 trained with one bearded and moustached wearer. It has no independent clean-shaven validation yet. Quick refinement and Focused training extend the model selected under Live tracking > Tongue model, including Mustachio; copies made from an experimental model retain that status.

Guides

  • Text setup instructions
  • Detailed release notes
  • Quest Pro rooting guide by glorpette and Fwooffy

Repository layout

The runnable release keeps the Hub and guide in its main folder. This GitHub repository keeps the development source, tests, and build scripts together in src/. Building a package requires the .NET 10 SDK, an installed VRCFaceTracking, and the binary assets from an extracted Qpro release. Older releases contain a Python installer instead of the NuGet archive required by this build, so the script downloads the pinned official Python 3.12.10 archive when needed and verifies its SHA-256 hash. For an offline build, supply python-runtime/python.3.12.10.nupkg in the source folder or asset root. In PowerShell, replace both example paths with paths on your PC:

cd src
.\build-release.ps1 -VrcftInstallDir '<your VRCFaceTracking install folder>' -AssetRoot '<extracted Qpro release>\QproRuntime'

For help, share relevant Hub Activity lines in the community Discord. The server is not owned by Fwooffy. QproFaceTracking is unaffiliated with Meta, Virtual Desktop, VRCFaceTracking, and VRChat.

Credits

  • n0tmast3r created the original Qpro-Enhanced-FT project that this edition is based on.
  • Fwooffy maintains this edition and wrote its beginner face tracking guide.
  • Lumince and the Singularity contributors created the headset root project used by this workflow.
  • danwillm and the LinkFT contributors documented the Steam Link tracking source used by Qpro's module.
  • Fwooffy wrote the original beginner Quest root guide, and glorpette made and hosts its GitHub version.