v2026.9.21.0-beta

VRCFaceTracking v2026.9.21.0-beta

What's Changed

Bug Fixes

• fix(host): keep timer resolution and priority when the window is in the background by RealWhyKnot in 2de88ef
• fix(ipc): send module replies at once and stamp each leg of the round trip by RealWhyKnot in 405176e
• fix(osc): stop reloading the avatar config on every announcement by RealWhyKnot in 2e2cfee
• fix(modules): snapshot tracking data without holding the lock across Update by RealWhyKnot in 61ef623
• fix(mutations): warn when none are discovered by RealWhyKnot in ff2ed9e
• fix(modules): reject non-finite tracking data and snapshot it coherently by RealWhyKnot in 9aae295
• fix(sandbox): stop host crashes, packet corruption and send stalls by RealWhyKnot in 0732a6c
• fix(osc): keep sending a batch past an oversized message by RealWhyKnot in 01b6fe5
• fix(release): take the file integrity table from the build manifests by RealWhyKnot in 17fc7db

Performance

• perf(ui): stop the init spinner animating while it is hidden by RealWhyKnot in 834c58e
• perf(osc): cut receive CPU and per-tick work by RealWhyKnot in 94e3d15

Changes

• refactor(release): hash archives with the shared checksums action by RealWhyKnot in 7b05f37

Other

• style: apply dotnet format by RealWhyKnot in 18dc053

Full Changelog: v2026.9.18.0...v2026.9.21.0-beta

File integrity

Asset	Size (MiB)	SHA-256
VRCFaceTracking-2026.9.21.0-beta-linux-arm64.tar.gz	57.29	7884c8c2747198dd0d7fec28aff678733f881b696c75332b001ae0f84dd19882
VRCFaceTracking-2026.9.21.0-beta-linux-x64.tar.gz	59.98	ea4d908e2f91b0a5256725187d84514191e88d7302b5141f73694538b505e500
VRCFaceTracking-2026.9.21.0-beta-osx-arm64.tar.gz	46.40	80be48104ad6235920c63b7e4f9a82b98e8a505e313454a43b33026b0c324913
VRCFaceTracking-2026.9.21.0-beta-osx-x64.tar.gz	48.50	75943202a6ed34f9ca24ae1817f27923a71e99e9b9ea20af251e8ab1cb431461
VRCFaceTracking-2026.9.21.0-beta-win-arm64.zip	48.07	1ab2e26cf49747739519db69d13181799af8849eea93f4fba49d69f54580b5e9
VRCFaceTracking-2026.9.21.0-beta-win-x64.zip	50.21	44bc507dec16e6fdd86259b28bad59b46ddd9ac8782f737893cf9db6a0623f39

Per-file hashes ship beside each archive as a matching .integrity.tsv asset.

More

• README: https://github.com/RealWhyKnot/VRCFaceTracking
• Source: commit 18dc053fadc3 on main
• License: Apache-2.0
• Upstream project: benaclejames/VRCFaceTracking (avatar setup and module docs at https://docs.vrcft.io)

Install on Windows

1. Download VRCFaceTracking-2026.9.21.0-beta-win-arm64.zip or VRCFaceTracking-2026.9.21.0-beta-win-x64.zip from this release.
2. Extract it anywhere except Program Files.
3. Run VRCFaceTracking.exe. Install your tracking module from the Module Registry tab if you have not before.
4. Launch VRChat with OSC enabled. The Home tab shows the module as active once it is receiving data.

Settings and installed modules live in %AppData%\VRCFaceTracking and are shared with the Steam build, so an existing setup carries over.

Install on Linux

1. Download VRCFaceTracking-2026.9.21.0-beta-linux-arm64.tar.gz or VRCFaceTracking-2026.9.21.0-beta-linux-x64.tar.gz from this release, picking the file that matches your CPU.
2. Extract it into its own folder: mkdir vrcft && tar -xzf <archive> -C vrcft.
3. If the app is not executable after extraction, run chmod +x VRCFaceTracking in that folder.
4. Run ./VRCFaceTracking.

Minimal distros also need libice6 and libsm6 installed.

Install on macOS

1. Download VRCFaceTracking-2026.9.21.0-beta-osx-arm64.tar.gz or VRCFaceTracking-2026.9.21.0-beta-osx-x64.tar.gz from this release, picking the file that matches your CPU (Apple Silicon is osx-arm64).
2. Extract it into its own folder and run ./VRCFaceTracking from there.

If Gatekeeper blocks the app, run xattr -dr com.apple.quarantine on the extracted folder and start it again. SteamVR features are unavailable on macOS.

Uninstall

Close VRCFaceTracking and delete the extracted folder. Settings and modules stay in %AppData%\VRCFaceTracking and logs in %LocalAppData%\VRCFaceTracking\logs; delete those two folders too for a clean removal.

What you need to do

Fresh install: follow the install steps above. Existing installs are offered this update when the app starts; accept it and the app downloads, verifies and applies the archive for your platform, then restarts. You can also close the app and extract the archive over the old folder by hand.

Beta releases log verbosely by default. Stable releases log warnings and errors only; turn on verbose logging under Settings, Diagnostics before reproducing a problem. When reporting a bug, attach the newest vrcft_*.log and vrcft_module_*.log from the log folder (Settings, Diagnostics, Open folder).