steamvr quick-start refresh

content/docs/steamvr/quick-start.md

@@ -7,7 +7,7 @@ title: Quick Start
 
 ## Check your Video Drivers
 
-- {{< icon name="nvidia" >}} Nvidia users: use the version that's [officially listed as production](https://www.nvidia.com/en-us/drivers/unix/). new feature/beta versions tend to have issues. open driver recommended on 20 series cards or newer.
+- {{< icon name="nvidia" >}} Nvidia users: use the version that's [officially listed as production](https://www.nvidia.com/en-us/drivers/unix/). new feature/beta versions tend to have issues.
 - {{< icon name="amd" >}} AMD users: use Mesa 24+ radeonsi, kernel 6.7.3+ if possible, stay away from amdpro.
 
 ## Dual-GPU Systems
@@ -15,19 +15,20 @@ title: Quick Start
 - AMD+AMD laptop or desktop: Amazing choice, you have nothing to do.
 - Desktop with iGPU and dGPU of different brands: Disable your iGPU in BIOS.
 - Laptop with Nvidia dGPU:
-  - **Option 1 (Ubuntu-only)**: Try the official Ubuntu solution `prime-select nvidia`.
-  - **Option 2**: Use `optimus-manager-qt` and switch to Nvidia.
+  - **Option 1 (Ubuntu-derivatives)**: Try the official Ubuntu solution `prime-select nvidia` before launching Steam.
+  - **Option 2**: Use `optimus-manager-qt` ([AUR](https://aur.archlinux.org/packages/optimus-manager-qt)) and switch to Nvidia before launching Steam.
   - **Option 3**: Launch steam, steamvr and all games with `prime-run` (Launch options: `prime-run %command%`)
   - **Extra tips**:
-    - Use regular nvidia proprietary driver instead of nvidia-open.
     - Make ABSOLUTELY sure you don't have weird stuff like amdvlk, including lib32 installed when you have Nvidia (check `ls /usr/share/vulkan/icd.d`)
-    - Stick to the PRODUCTION branch of Nvidia drivers (535 as of writing), newer ones may or may not work.
+    - Stick to the PRODUCTION branch of Nvidia drivers, newer ones may or may not work.
 
 ## Installing Steam
 
-If the `steam` package is available on your distro, we recommend starting with that. For headsets using ALVR, the flatpak steam can work, but it's more of an advanced topic. ALVR docs can help you with that.
+If the `steam` system package is available on your distro, we recommend starting with that.
 
-Launch Steam and install SteamVR. If it repeatedly nags you about sudo upon launch, you might want to setcap the vrcompositor:
+**Flatpak Steam is not recommended**, as there are be capabilities that cannot be granted inside Flatpak, resulting in ghosting/stutter.
+
+Launch Steam and install SteamVR. If it repeatedly nags you about sudo upon launch, setcap the vrcompositor manually:
 
 ```bash
 sudo setcap CAP_SYS_NICE=eip ~/.local/share/Steam/steamapps/common/SteamVR/bin/linux64/vrcompositor-launcher
@@ -39,27 +40,21 @@ sudo setcap CAP_SYS_NICE=eip ~/.local/share/Steam/steamapps/common/SteamVR/bin/l
 
 **Valve Index, Vive, Vive Pro**: These will work just by plugging in.
 
-**Vive Pro 2** will need the driver from here: <https://github.com/CertainLach/VivePro2-Linux-Driver>
+**Vive Pro 2** will need the driver from here: [VivePro2-Linux-Driver on GitHub](https://github.com/CertainLach/VivePro2-Linux-Driver)
 
-If you use any of the above headsets with {{< icon name="nvidia" >}} Nvidia , you may get flickering or crashes. In this case, check your settings in `~/.steam/steam/config/steamvr.vrsettings`
+**Bigscreen Beyond** requires a patched kernel: [Bigscreen Beyond Kernel Patch](https://gist.githubusercontent.com/TayouVR/af8635a4b8e1d02d038be1be1d221c83/raw/3806a6ff0a03721904164277d7523d43f7ca383c/bigscreenBeyond.patch)
 
-Under the `"steamvr"` section:
+If you use any of the above headsets with {{< icon name="nvidia" >}} Nvidia , you may get a smoother experience with Monado + OpenComposite (use Envision for easy setup), albeit this combo does not work with all VR titles.
 
-```js
-"allowSupersampleFiltering" : false,
-"disableAsync" : true,
-"enableLinuxVulkanAsync" : false,
-```
-
-For many games, you might want to turn on "Legacy Reprojection" in the per-app video settings.
+For many games, you might want experiment with "Legacy Reprojection" in the per-app video settings.
 
 **Quest 1/2/3/Pro, Pico 3/4, Vive Focus 3/XR Elite**:
 
 Your best bet is [the latest ALVR release](https://github.com/alvr-org/ALVR/releases)
 
-Also check the [ALVR wiki](https://github.com/alvr-org/ALVR/wiki)
+Also check the [ALVR wiki](https://github.com/alvr-org/ALVR/wiki), especially the [Linux Troubleshooting](https://github.com/alvr-org/ALVR/wiki/Linux-Troubleshooting) section.
 
-## Auto-Restart Script
+## Optional: Auto-Restart Script
 
 The `startvr` script [here](https://gist.github.com/galister/a85135f4a3aca5208ba4091069ab2222) is meant to make launching SteamVR less tedious.
 
@@ -87,3 +82,18 @@ To use the script, simply launch it from a terminal. It will ask for sudo passwo
 ALVR-only: If you get a SteamVR error after this, Ctrl-C the script, open ALVR dashboard and launch SteamVR from there once. You then don't have to open ALVR until there's a SteamVR update.
 
 If you need to restart SteamVR, simply exit it using your overlay and it'll be restarted for you. To really exit SteamVR, first Ctrl-C the script.
+
+## Optional: Disable SteamVR dashboard
+
+Since the SteamVR dashboard has some major issues with high CPU usage, occasional freezing and sometimes going completely unresponsive.
+
+Many choose to disable SteamVR dashboard and use something like WlxOverlay-S instead for desktop + game library access.
+
+To do this, simply remove the execute permission from `vrwebhelper`:
+
+```bash
+chmod -x ~/.steam/steam/steamapps/common/SteamVR/bin/vrwebhelper/linux64/vrwebhelper
+
+```
+
+(To re-enable, run the same command but with `+x` instead of `-x`.)