v2026.5.22.0-beta

WKVRCProxy v2026.5.22.0-beta

What's Changed

Features

• feat(updater): opt-in to prereleases for both startup nudge and updater by @RealWhyKnot in 44d6b81
• feat(wrapper): reactive og fallback on observed AVPro load_failure by @RealWhyKnot in 59dc5d7
• feat(helper): hold-and-announce flow for window-pull leases by @RealWhyKnot in 100e71f
• feat(helper): surface helper_eligibility_skipped frames on watchdog console by @RealWhyKnot in f402c53

Bug Fixes

• fix(helper): fall back to container duration when stream tag missing by @RealWhyKnot in b39602a
• fix(relay): scope manifest classification to .m3u8/.mpd extensions by @RealWhyKnot in d23943d
• fix(helper): run video-duration check on every decode path by @RealWhyKnot in f66790f
• fix(helper): widen NVDEC pool to 32 + retry truncated video via software by @RealWhyKnot in ab18327
• fix(helper): route seg 0 through software decode + reject empty output by @RealWhyKnot in 0aca4ac
• fix(helper): NVENC scale_cuda filter syntax and NVDEC reference-frame pool by @RealWhyKnot in 0d339d3

Refactors

• refactor(helper): hardcode GPU throttle; refuse integrated GPUs by @RealWhyKnot in 79439bd

CI

• ci(release): add -beta prerelease handling, gate promotion PR by @RealWhyKnot in d54869a

Build

• build: tighten beta suffix back to plain -beta by @RealWhyKnot in 80bf956
• build: accept YYYY.M.D.N-betaN tag shape for prerelease publishes by @RealWhyKnot in eca1136

Full Changelog: v2026.5.16.0...v2026.5.22.0-beta

File integrity

This immutable release predates the attached integrity TSV; GitHub records the release zip SHA256 in the release asset metadata.

More

• README: https://github.com/RealWhyKnot/WKVRCProxy
• Source: commit 80bf9565de03 on main
• License: GPL-3.0

Install (fresh)

1. Launch VRChat at least once so it has dropped its bundled yt-dlp.exe into its Tools dir.
2. Download WKVRCProxy-v2026.5.22.0-beta.zip from this release.
3. Extract anywhere except Program Files.
4. Run WKVRCProxy.exe. Accept the UAC prompt to add the hosts entry.
5. Launch VRChat. Watch for [mesh] connected in the watchdog window. Paste a URL in any in-world video player.

Full walkthrough: README quick start.

Uninstall

Run WKVRCProxy.Uninstaller.exe from the install folder. No prompt; runs to completion. Restores the original yt-dlp.exe, removes the hosts entry, wipes %LOCALAPPDATA%Low\WKVRCProxy\, deletes the install directory.

What you need to do

Fresh install: follow the install steps above. Existing installs can be replaced with this zip, or updated by launching WKVRCProxy.exe and typing /update. The updater downloads this release, verifies the zip, atomically swaps the files, and relaunches.

If you hit a playback bug after this release: re-paste the URL with the watchdog window visible, copy the watchdog log starting from the failed request, and include both in the bug report.