Skip to content

v2026.9.16.1-beta

Pre-release
Pre-release

Choose a tag to compare

View all tags
@github-actions github-actions released this 16 Sep 11:40
· 68 commits to main since this release
v2026.9.16.1-beta
cf94689
This commit was signed with the committer’s verified signature.
RealWhyKnot WhyKnot
SSH Key Fingerprint: cal0Z742iEQwSfOr39iHtXz2tM/D3AbmWHder5AQoYE
Verified
Learn about vigilant mode.

VRCFaceTracking v2026.9.16.1-beta

What's Changed

Features

  • feat(release): ship Windows, Linux, and macOS builds with a per-OS updater by RealWhyKnot in d745b4f
  • feat(mutations): master switch and developer-gated tuning controls by RealWhyKnot in d5bc4e4
  • feat(settings): developer mode, changeable log folder, and camera stream view by RealWhyKnot in 90ff342
  • feat(ui): settings and capability controls, shared styling, output page rework by RealWhyKnot in 1285694
  • feat(modules): report startup progress and stream camera frames over module IPC by RealWhyKnot in 3738b28
  • feat(ui): add cross-platform Avalonia app head alongside the WinUI app by RealWhyKnot in dca36f6
  • feat(modules): per-module capability restrictions persisted across sessions by RealWhyKnot in a18964c
  • feat(modules): run multiple modules at once with deterministic capability assignment by RealWhyKnot in c81aa80

Bug Fixes

  • fix(build): track the Windows OpenVR runtime so clean checkouts build by RealWhyKnot in b8d3c45
  • fix(logging): sanitize module log names identically on every platform by RealWhyKnot in 707c521
  • fix(mutations): leave the eye and mouth/brow assists off by default by RealWhyKnot in ce5abf2
  • fix(ui): review fixes for settings, registry, and page lifecycle by RealWhyKnot in 809c2f6
  • fix(modules): harden init, restart, and IPC paths found in review by RealWhyKnot in 1a60fb8
  • fix(ui): stop the tracking settings page crashing the app and drop the inherited telemetry config by RealWhyKnot in a992198
  • fix(core): resolve data directories on machines without existing config folders by RealWhyKnot in c2a1f0a
  • fix(core): run without a local VRChat or Steam install by RealWhyKnot in 263a502
  • fix(modules): guard shared tracking data against concurrent merge and send by RealWhyKnot in 6eb7ea1
  • fix(modules): correct capability claim bookkeeping across multiple modules by RealWhyKnot in 116b439

Changes

  • refactor(ui): replace the WinUI app with the Avalonia app as the single head by RealWhyKnot in b495d68
  • refactor(mutations): label each card's toggle instead of adding a master switch by RealWhyKnot in 4195d70
  • refactor(modules): route module data through capability groups at the merge point by RealWhyKnot in 5e28697

Documentation

  • docs: describe cross-platform support and multi-module tracking by RealWhyKnot in cd8ace8

CI

  • ci(release): draft-first releases, arm64 assets, and sturdier verification by RealWhyKnot in 155f680
  • ci(contributors): bundle a generated contributors list with the app by RealWhyKnot in ea3bf10

Tests

  • test(ui): render every page headlessly and cover the mutator templates by RealWhyKnot in 1be5d21
  • test(ipc): stop parallel split-packet tests from sharing reassembly state by RealWhyKnot in a3617a5

Chores

Other

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

File integrity

Asset Size (MiB) SHA-256
VRCFaceTracking-2026.9.16.1-beta-linux-arm64.tar.gz 57.27 66740138f5cee4ae374d5b24b9de8eed544d142156f410ed38ea2da8ce829be8
VRCFaceTracking-2026.9.16.1-beta-linux-x64.tar.gz 59.96 8812ec27a018f578eecc87978da1965b4e20eba9608ca9cfb2d2ebbc18fa247f
VRCFaceTracking-2026.9.16.1-beta-osx-arm64.tar.gz 46.36 d6b2affc9e742e1f15f687f558db16113f6ea626a12fd2fc099e53b3e15f15a8
VRCFaceTracking-2026.9.16.1-beta-osx-x64.tar.gz 48.47 d4c298ffc3ee614c9c7cdd8aa597b3160f77d6944d90b5dce5466039d47181b4
VRCFaceTracking-2026.9.16.1-beta-win-arm64.zip 48.04 cd85a7277afc5e74460967815d630f7cb3bb5fb52ec5e082b768db7e3b5f080f
VRCFaceTracking-2026.9.16.1-beta-win-x64.zip 50.19 bfe8257b90e795b50bc4ba14b9e3c12e14d0a43607c4c3836fae8d6b108076f1

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

More

Install on Windows

  1. Download VRCFaceTracking-2026.9.16.1-beta-win-arm64.zip or VRCFaceTracking-2026.9.16.1-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.16.1-beta-linux-arm64.tar.gz or VRCFaceTracking-2026.9.16.1-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.16.1-beta-osx-arm64.tar.gz or VRCFaceTracking-2026.9.16.1-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).

Assets 14
Loading