VSA provides image compression functionality using the JPEG XL (JXL) format. This guide explains how to configure and use JXL compression.
JPEG XL is a next-generation image format with the following features:
VRChat screenshots are typically saved as PNG, but JXL compression can reduce file size by over 50%.
Click “JXL Compression” in the sidebar to open the compression screen.
The screen has two tabs:
Automatically executes compression on a regular schedule.
| Setting | Description |
|---|---|
| Interval | Compression interval (monthly) |
| Start Day | Which day of the month to start |
| Next Run | Next scheduled execution date |
| Setting | Description |
|---|---|
| Auto Start | Automatically start when conditions are met |
| Start Trigger | File count threshold for auto start |
| Monitor Interval | Folder monitoring interval (minutes) |
| Consider VRChat State | Pause while VRChat is running |
When “Consider VRChat State” is enabled, compression processing pauses while VRChat is active. This prevents performance degradation during gameplay.
When a compression reminder appears, you can select from the following snooze options:
Select any folder and execute compression.
Batch Processing:
Background Processing:
During processing, the following information is displayed:
You can restore compressed JXL files back to original PNG.
The extracted PNG files will have the original metadata restored.
You can change detailed JXL compression settings in the settings screen.
| Value | Description |
|---|---|
| 0-3 | Fast but lower compression ratio |
| 4-6 | Balanced |
| 7-9 | Slow but high compression ratio |
The default value is 7, which balances compression ratio and processing speed.
VSA only supports lossless (reversible) compression. This means:
After compression completes, the following information is displayed:
A metadata.json file is also generated in each folder, recording compression history.
Running compression while playing VRChat may cause the following issues:
It is recommended to exit VRChat before running compression whenever possible.
During compression, both input and output files exist, so additional disk space is temporarily required.
Ensure sufficient free space (approximately 1.2x the input file size).
Original PNG files are not automatically deleted after compression. If you want to save disk space, manually delete them after confirming compression completed successfully.
Images that are already efficiently compressed or have simple content may have lower compression ratios.
Saving in formats other than JXL may cause VSA metadata to be lost. Always use VSA’s compression feature.