From b1e24e67df9e90c7b110ef90c23a2cd5cae33ec1 Mon Sep 17 00:00:00 2001
From: galister <3123227-galister@users.noreply.gitlab.com>
Date: Fri, 16 Feb 2024 11:13:26 +0000
Subject: [PATCH] add section about startvr

---
 content/docs/steamvr/quick-start.md | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/content/docs/steamvr/quick-start.md b/content/docs/steamvr/quick-start.md
index 210b9cc..eeff06a 100644
--- a/content/docs/steamvr/quick-start.md
+++ b/content/docs/steamvr/quick-start.md
@@ -45,3 +45,25 @@ For many games, you might want to turn on "Legacy Reprojection" in the per-app v
 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)
+
+## Auto-Restart Script
+
+The `startvr` script [here](https://gist.github.com/galister/a85135f4a3aca5208ba4091069ab2222) is meant to make launching SteamVR less tedious.
+
+It can be used with both ALVR and wired headsets.
+
+What it does:
+- Whitelist drivers for SpaceCal and ALVR so these will never get blocked
+- Apply bindings spam patch by Plyshka
+- Setcap the compositor after a SteamVR update
+- Start SteamVR and restart it for you in case of a crash
+
+Extra steps when using with ALVR:
+- Under `Installation` tab, register the ALVR driver
+- Under `Settings`, `Steamvr Launcher` section, set `Driver launch action` to `No action`.
+
+If you've installed Steam in a non-standard location, change the variable on the top of the script.
+
+To use the script, simply launch it from a terminal. It will ask for sudo password in case your SteamVR has been freshly installed or updated and it needs to `setcap` the compositor.
+
+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.