wiki/Settings-tutorial.md
Applicable to ALVR v20.
This tutorial will help you find optimal settings for your hardware and network as well as give you some pointers to troubleshoot common configuration issues.
To get a sharp image, you need combination of high resolution, enough sharpening, good bitrate with chosen codec. For example, on good wireless router you can use medium resolution preset (default) with 1.0 sharpening (higher than default) with H.264 set at constant 400-500 mbps, or hevc at costant 100-150 mbps. In wired case, you can go all the way to 800-1000 mbps constant bitrate on H.264.
Next, choose a refresh rate. Obviously higher is better, but on weaker/older hardware it's often preferable to use a lower setting that gives consistent results. For the Quest 2, 120 Hz has to be enabled in its settings.
A few notes on codec choices:
Enable foveated encoding. Go to the SteamVR void and look closely at the framerate graph under the latency graph in the statistics tab.
Repeat until you are at the maximum of what your encoder can do.
Slowly increase bitrate until one of two things happen:
If you notice micro-stuttering on the headset, especially in busy scenes with fast motion, slowly increase maxBufferingFrames until the playback is smooth.
Keep in mind that increasing maxBufferingFrames will linearly increase latency; if the value that gives a smooth playback results in too high of a latency for your use case, try a different codec, a lower bitrate and/or stronger foveation settings.
By that point, your latency graph and your playback should be smooth and consistent. Enjoy!
See also the Troubleshooting page for more help.