v2026.10.9.0-beta

VRCFaceTracking v2026.10.9.0-beta

What's Changed

Bug Fixes

• fix(build): build the module process as Any CPU in Any CPU solution builds by RealWhyKnot in 4288eab

Performance

• perf(osc): wake the sender only for new data or a due refresh by RealWhyKnot in 9fc18cc
• perf(module): wait for queued packets instead of polling every 20 ms by RealWhyKnot in f6a942a
• perf(ipc): read update packets in place instead of marshalling them by RealWhyKnot in 452837d
• perf(osc): stop boxing the Vector4 eye parameter on every tick by RealWhyKnot in f60e34b

Documentation

• docs: rewrite the README, privacy note and release templates by RealWhyKnot in e0f19a3

Tests

• test(perf): log module start failures and widen module CPU budgets by RealWhyKnot in 071335d
• test(perf): add CPU, wake, allocation and memory budget tests by RealWhyKnot in 7a455f5

Full Changelog: v2026.10.7.0-beta...v2026.10.9.0-beta

File integrity

Asset	Size (MiB)	SHA-256
VRCFaceTracking-2026.10.9.0-beta-linux-arm64.tar.gz	65.73	ca82b95667589521cf89ef9a38bda098f815f9f87a23969445102b2ffc7efd99
VRCFaceTracking-2026.10.9.0-beta-linux-x64.tar.gz	69.54	6788af1a27d81c94e5e21a76b72c98a2a7586fbeb04359974bfd4febc24ecd6c
VRCFaceTracking-2026.10.9.0-beta-osx-arm64.tar.gz	54.80	f6e51d012c71c9754408758a399646a90db0818ad193ac821ce6efdad38cb380
VRCFaceTracking-2026.10.9.0-beta-osx-x64.tar.gz	58.05	fcc3674b23ba292d0d377206c242ae1934efcc0753a146314a6d49167e192c02
VRCFaceTracking-2026.10.9.0-beta-win-arm64.zip	56.80	36bdd4dec0575c7041bb00783412a38c5d4a30c5dd53384a3e61cc3eed1bf7ed
VRCFaceTracking-2026.10.9.0-beta-win-x64.zip	60.00	b3d86b7efa891bd7053f1e1abfe5c4cd13070db69bfa588ca5c70b225ffdf456
VRCFaceTracking-Setup-2026.10.9.0-beta.exe	42.76	bfb3f23eda4cfa432f473f123e279a53ce1efe0f5742f8ae34c1011cd08fcf55

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

More

This release is commit 071335d4776c on main, licensed Apache-2.0. See the README for install notes. Upstream is benaclejames/VRCFaceTracking, and its avatar setup and module docs are at https://docs.vrcft.io.

Install on Windows

1. Download VRCFaceTracking-Setup-2026.10.9.0-beta.exe from this release and run it. It installs for your Windows account only, without an admin prompt, and adds VRCFaceTracking to the Start menu.
2. Start VRCFaceTracking. If you haven't installed your tracking module before, get it from the Module Registry tab.
3. Launch VRChat with OSC enabled. Once the module is receiving data, the Home tab shows it as active.

Setup also registers this copy with SteamVR. If an older copy you extracted by hand had "Start with SteamVR" turned on, SteamVR starts the installed copy from now on.

To run it without installing, extract VRCFaceTracking-2026.10.9.0-beta-win-arm64.zip or VRCFaceTracking-2026.10.9.0-beta-win-x64.zip anywhere except Program Files and run VRCFaceTracking.exe.

Settings and installed modules are kept in %AppData%\VRCFaceTracking, the same folder the Steam build uses. An existing setup carries over.

Install on Linux

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

Minimal distros also need libice6 and libsm6.

Install on macOS

1. Download VRCFaceTracking-2026.10.9.0-beta-osx-arm64.tar.gz or VRCFaceTracking-2026.10.9.0-beta-osx-x64.tar.gz from this release. Pick the file for 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 don't work on macOS.

Uninstall

If you used the setup, uninstall VRCFaceTracking from Settings, Apps, Installed apps. The app, its Start menu entry and its SteamVR registration are removed, and then the uninstaller offers to delete your settings, installed modules and logs as well. Say No if you also use the Steam version. It reads the same settings and modules.

If you extracted it by hand, close VRCFaceTracking and delete the folder. Settings and modules are in %AppData%\VRCFaceTracking and logs in %LocalAppData%\VRCFaceTracking\logs. Delete those two folders too to remove everything.

What you need to do

New installs: follow the install steps above. Existing installs get offered this update when the app starts. Accept it and the app downloads, verifies and applies the update, then restarts. Installed copies update by running the new setup silently. Extracted copies get the new archive copied over their folder, or you can close the app and extract it over the old folder yourself.

To switch from an extracted copy to the setup, run the setup and start VRCFaceTracking from the Start menu. Settings and modules carry over. Delete the old folder once the installed copy works.

Beta releases log verbosely by default and stable releases log only warnings and errors. Before reproducing a problem on a stable release, turn on verbose logging under Settings, Diagnostics. Bug reports need the newest vrcft_*.log and vrcft_module_*.log from the log folder (Settings, Diagnostics, Open folder).