v2026.10.7.0-beta

VRCFaceTracking v2026.10.7.0-beta

What's Changed

Features

• feat(updates): update installed copies by running the new setup silently by RealWhyKnot in 933985c
• feat(installer): add a per-user Windows installer by RealWhyKnot in 066e9ca
• feat(steamvr): add --register-steamvr and --unregister-steamvr by RealWhyKnot in a861472

Bug Fixes

• fix(steamvr): match registered manifests by their long path by RealWhyKnot in beba2e3
• fix(mutations): save on/off switches and adjustment ranges when changed by RealWhyKnot in 7ce0777
• fix(settings): apply the OSC address when the field loses focus by RealWhyKnot in 0daa8c5
• fix(osc): receive on a non-loopback address instead of refusing it by RealWhyKnot in cb546c0
• fix(osc): send to the configured address after it loads or changes by RealWhyKnot in cca0973

Documentation

• docs: install with the setup on Windows by RealWhyKnot in 20b44dd
• docs: plain release links by RealWhyKnot in cf0247d

CI

• ci(release): build, test and publish the Windows setup with each release by RealWhyKnot in aea3450

Tests

• test(osc): wait for four idle refreshes instead of counting a fixed 250 ms window by RealWhyKnot in 2d64afe
• test(settings): give the OSC target valid ports before checking the address commit by RealWhyKnot in ef9d54a
• test(installer): compare install paths in long form by RealWhyKnot in eac100b

Other

• diag(mutations): log each adjustment's settings when it loads by RealWhyKnot in 5849690

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

File integrity

Asset	Size (MiB)	SHA-256
VRCFaceTracking-2026.10.7.0-beta-linux-arm64.tar.gz	65.73	f25a82d021a7c61df04e7e564a7dcd1f5efc08371a044679fab9a4e9554dee78
VRCFaceTracking-2026.10.7.0-beta-linux-x64.tar.gz	69.53	4d66caca0f86b43b7941c822689b4b631fa3ece72b9eaa853883191f9040b378
VRCFaceTracking-2026.10.7.0-beta-osx-arm64.tar.gz	54.80	020173864ef8c83a33bbc228a29abef395e13e295c4bb1d43c0bd3edcd9a3e18
VRCFaceTracking-2026.10.7.0-beta-osx-x64.tar.gz	58.05	46002617562bfeeaaed099a801e3a9a1df233491ab6ca8699d05dd9820f07c9a
VRCFaceTracking-2026.10.7.0-beta-win-arm64.zip	56.80	76141c43a1838aee8d6baccce67925faeefb4e83e5dad62c2942864facb5ea4d
VRCFaceTracking-2026.10.7.0-beta-win-x64.zip	59.99	4b9c07adaf2c2233184bff6fdc41eecd059cd331b223bcc96ab0b637880c6ea1
VRCFaceTracking-Setup-2026.10.7.0-beta.exe	42.75	0405a6fcbeef65d86d151f3a16dd1e3050b3d5fe9b0430288f5bc946ddb912d1

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

More

• README: https://github.com/RealWhyKnot/VRCFaceTracking
• Source: commit 2d64afe5f13b on main
• License: Apache-2.0
• Upstream: benaclejames/VRCFaceTracking, with avatar setup and module docs at https://docs.vrcft.io

Install on Windows

1. Download VRCFaceTracking-Setup-2026.10.7.0-beta.exe from this release and run it. It installs for your Windows account only, with no admin prompt, and adds VRCFaceTracking to the Start menu.
2. Start VRCFaceTracking. Install your tracking module from the Module Registry tab if you haven't before.
3. Launch VRChat with OSC enabled. The Home tab shows the module as active once it's receiving data.

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

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

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.10.7.0-beta-linux-arm64.tar.gz or VRCFaceTracking-2026.10.7.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.10.7.0-beta-osx-arm64.tar.gz or VRCFaceTracking-2026.10.7.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

Installed with the setup: open Settings, Apps, Installed apps, and uninstall VRCFaceTracking. That removes the app, its Start menu entry and its SteamVR registration. It then asks whether to delete your settings, installed modules and logs too. Answer No if you also use the Steam version, because it reads the same settings and modules.

Extracted by hand: close VRCFaceTracking and delete the 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 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 by hand.

Switching from an extracted copy to the setup: run the setup, then 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. 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).