Language:English | 日本語 | Magyar | 한국어 | Português do Brasil
Install the original VRCVideoCacher cookie extension (default — use these):
The VRCVideoCacherPlus extensions (BrowserExtension/) are in early testing and should send cookies. You can choose: manual send & copy, automatic sharing, and/or app-triggered cookie refresh. They're not on the extension stores yet, so install them unpacked. Unpacked extensions don't update automatically: after pulling a new version, reload the extension yourself.
How to install the unpacked extension (Chrome / Firefox)
Download or clone this repo so you have the BrowserExtension/ folder locally.
Chrome (and Chromium-based browsers like Edge, Brave):
- Open
chrome://extensions - Enable Developer mode (top right)
- Click Load unpacked and select the
BrowserExtension/chrome/folder OR drag and drop theBrowserExtension/chrome/into the extensions window
Firefox:
- Open
about:debugging#/runtime/this-firefox - Click Load Temporary Add-on… and select
BrowserExtension/firefox/manifest.json - Note: temporary add-ons are removed when Firefox closes and must be re-loaded each time. For a persistent install, use Firefox Developer Edition or Nightly with
xpinstall.signatures.requiredset tofalseinabout:config, zip theBrowserExtension/firefox/folder contents, and install the zip viaabout:addons
VRCVideoCacherPlus helps VRChat videos play. Sometimes, YouTube blocks or throttles videos when a user client does not provide cookies. This app gives YouTube the cookies while you play VRChat so that videos play smoothly and in high definition. This app also downloads videos intelligently if you turn that setting on, so that videos you play often (e.g. VRDancing) don't need to download from the internet again. You can manage the video cache, change the background download speed, and delay the video download (so that you're not downloading two video files or more at the same time). VRCVideoCacherPlus is based on VRCVideoCacher and adds many improvements, like HLS and streaming playlist (.m3u8) video support.
Main screen — status, cache size, and what the app is doing right now.
Cache settings — limit background download speed and delay downloads so they don't compete with the video you're watching.
Cookies — the beta browser extension can refresh your YouTube cookies automatically, on request from the app.
- Pause cache downloads while streaming
- Cache download speed limit
- Download queue & manual downloads
- Cache HLS / streaming-video playlists
- Other improvements
- Builds
Details on each feature
You can make cache downloads pause automatically when VRChat is playing a streaming video. Set the delay (in seconds) to how long after the stream stops before downloads resume. Set to 0 to disable.
Tip: If you watch long videos or looping content, use the speed limit below instead (or alongside this).
You can limit how fast cache downloads run (in MB/s). Set to 0 for unlimited.
Recommended usage: Set the pause delay to 300 seconds to cover switching videos or queuing songs, and use the speed limit as a backup for longer playback.
You can manually queue videos for caching from the Downloads tab. Paste one or more YouTube URLs (one per line) into the text box and click Add. YouTube playlists are also supported — paste the playlist URL and all videos in the playlist will be added to the queue automatically.
Finished HLS streaming playlists (.m3u8 and mpegts variants like VRDancing's beta mpegts videos) can now be cached as MP4 for later playback. Detection is content-based, so playlists served without a .m3u8 extension still get picked up. Live streams (no #EXT-X-ENDLIST) are skipped, and a max-length cap is configurable in Cache Settings (set to 0 for unlimited).
Cloud share URLs: Dropbox links with ?dl=0 (the default share form) and Google Drive /file/d/<id>/view links are automatically rewritten to their direct-download form before fetching, so you can paste either form. Mega.nz isn't supported (encrypted, JS-only). Playlists whose segment URLs point to other protected files won't work — the manifest itself plus its segments must be on a directly-fetchable host.
- Update banner — shows a banner when a new version is available
- Better log entries in the log viewer
- Watch history with stats tracking intelligently saves cache space, keeping your favorite videos
- "Download Now" button on queued items — immediately starts downloading a specific item, skipping the idle-wait delay
- Video titles shown in the download queue
Fully user tested on Windows.
App start and basic functionality tested on Linux.
Steam app integration isn't supported yet. SteamVR integration is tested (e.g. starting this app with SteamVR)
For code feedback, feature ideas, and bugs, post a GitHub issue. You can leave general comments and feedback here: Feedback
FAQ from the EllyVR VRCVideoCacher README
It replaces VRChat's yt-dlp.exe with our own stub yt-dlp, this gets replaced on application startup and is restored on exit.
Auto install missing codecs: VP9 | AV1 | AC-3
From VRC or EAC? no.
From YouTube/Google? maybe, we strongly recommend you use an alternative Google account if possible.
In order to fix YouTube videos failing to load, you'll need to install the Chrome or Firefox extension. Visit YouTube, while signed in, at least once while VRCVideoCacher is running, and after VRCVideoCacher has obtained your cookies, the app will send those to YouTube for playing videos.
Loading failed. File not found, codec not supported, video resolution too high or insufficient system resources.
YouTube checks system time. Fix: Sync system time, Open Windows Settings -> Time & Language -> Date & Time, under "Additional settings" click "Sync now"
Windows:
- If you have VRCX, delete the startup shortcut "VRCVideoCacher" from
%AppData%\VRCX\startup - Delete config and cache from
%AppData%\VRCVideoCacher - Delete "yt-dlp.exe" from
%AppData%\..\LocalLow\VRChat\VRChat\Tools. Restart VRChat.
Linux:
- Delete config and cache from
~/.config/VRCVideoCacher - VRChat runs under Proton, so delete "yt-dlp.exe" from the Steam compat prefix:
~/.steam/steam/steamapps/compatdata/438100/pfx/drive_c/users/steamuser/AppData/LocalLow/VRChat/VRChat/Tools. Restart VRChat.