VRChat Animated Banner

Turn an image, GIF, or short video into a VRChat-ready WebP banner without leaving the VRChat website.

The extension prepares the file on your own device, shows you the result, and uploads it to your VRChat Photo Gallery only when you press Upload.

What it does

• Accepts common images, GIFs, and short videos.
• Creates a 16:9 WebP banner up to 2048 × 1152.
• Trims moving files to 8 seconds when needed.
• Reduces quality, frame rate, or dimensions until the result is safely below 10 MB.
• Shows clear progress while a conversion is running.
• Starts minimized and closes when you click elsewhere or move to another VRChat page.

Where to find it

After installing the extension, sign in at vrchat.com and look in the bottom-right corner. Click the floating Animated banner button.

The arrow in the image points to the floating button added by the extension.

What you will see

The uploader opens over the current VRChat page. Choose or drag a file into the large box, then follow the three steps shown at the top.

The small browser popup is another quick way to open the uploader:

Install

1. Open the latest release.
2. Download VRChat-Animated-Banner-Extension-v1.4.0.zip.
3. Extract the ZIP to a folder you will keep.
4. Open your browser's extensions page:
   • Opera GX: opera://extensions
   • Chrome: chrome://extensions
   • Edge: edge://extensions
5. Turn on Developer mode.
6. Choose Load unpacked and select the extracted folder containing manifest.json.
7. Open or reload VRChat Home.

Use

1. Sign in to VRChat normally.
2. Click Animated banner in the bottom-right corner.
3. Choose or drag an image, GIF, or short video.
4. Pick Fill and crop or Fit entire image.
5. Click Convert to WebP.
6. Review the size, dimensions, duration, and frames.
7. Click Upload to Photo Gallery.

The extension uploads the finished file to your Photo Gallery. It does not automatically change your profile picture or a group banner.

Supported files

• Images: JPG, JPEG, PNG, BMP, TIFF, AVIF, and WebP.
• Moving images: GIF, APNG, and animated WebP.
• Videos: MP4, M4V, MOV, WebM, MKV, AVI, MPEG, and MPG.

Damaged files, protected videos, and unusual codecs may not open. Animated WebP can be uploaded directly, but it cannot currently be recompressed by the included converter.

What to expect

• The first conversion may take a moment while the local conversion engine starts.
• A large or long file may need several automatic attempts to fit below 10 MB.
• Moving files longer than 8 seconds are shortened automatically.
• Important artwork should stay near the center because VRChat crops banners differently in different parts of the website.
• An active VRC+ subscription may be required to manage Photo Gallery.

Animated WebP banners are not officially documented as supported by VRChat, so accepted formats and website behavior may change.

Privacy

• Conversion happens locally in browser memory.
• The original file is not uploaded.
• Only the finished WebP is sent, and only after you click Upload.
• There is no telemetry.
• The extension does not ask for or store your password, cookies, token, or 2FA code.
• It uses the VRChat session already open in your browser.

For contributors

npm install
npm run prepare:vendor
npm test
npm run check
powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\build-package.ps1

Dependency information is in THIRD_PARTY_NOTICES.md.

License

GNU General Public License v3.0 or later. This is an independent community project and is not affiliated with, endorsed by, or maintained by VRChat.