v2026.9.17.0-beta

VRCFaceTracking v2026.9.17.0-beta

What's Changed

Bug Fixes

• fix(ui): make status colours follow the light and dark themes by RealWhyKnot in 253e0cc

Changes

• refactor(ui): bind module install state instead of poking the buttons by RealWhyKnot in e2b810a
• refactor(ui): share styles, scale layout to the window, and ease transitions by RealWhyKnot in 155b3bb

Chores

• chore(build): check every binding at compile time by RealWhyKnot in 433f19d
• chore(deps): move to Avalonia 11.3.22 and FluentAvalonia 2.5.1 by RealWhyKnot in af583dd

Other

• Delete docs/img directory by RealWhyKnot in 0362a01

Full Changelog: v2026.9.16.1-beta...v2026.9.17.0-beta

File integrity

Asset	Size (MiB)	SHA-256
VRCFaceTracking-2026.9.17.0-beta-linux-arm64.tar.gz	57.29	ff6cb81a2ff383c1d666df242bafaf21b44e2491c0dac0d2638efd2689582068
VRCFaceTracking-2026.9.17.0-beta-linux-x64.tar.gz	59.97	7eca79df05e4744fee055877395f226a2ff700da874ab60f9e2ce8f4ce626457
VRCFaceTracking-2026.9.17.0-beta-osx-arm64.tar.gz	46.39	b74430591dd02add4fc183203be14bde485d9ba2074b211146606d8331d2ebc7
VRCFaceTracking-2026.9.17.0-beta-osx-x64.tar.gz	48.50	b2542acc280db905f1223486341d14be7b659e9685114310e5f1c13c8fb13af5
VRCFaceTracking-2026.9.17.0-beta-win-arm64.zip	48.06	98a6b083aa1e2ce18a6ecdc27a3254494ec475ac8806a56b7d7dd33e53450c22
VRCFaceTracking-2026.9.17.0-beta-win-x64.zip	50.21	a030a127b8007ef0d12e74d30bb17858cf471d3fa8ce026b086144fe9b133870

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

More

• README: https://github.com/RealWhyKnot/VRCFaceTracking
• Source: commit e2b810af268f 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.17.0-beta-win-arm64.zip or VRCFaceTracking-2026.9.17.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.17.0-beta-linux-arm64.tar.gz or VRCFaceTracking-2026.9.17.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.17.0-beta-osx-arm64.tar.gz or VRCFaceTracking-2026.9.17.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).