From 4af5b84f7b1c58d321b82977f92151cc0d378c25 Mon Sep 17 00:00:00 2001 From: Gabriele Musco Date: Mon, 12 Feb 2024 13:26:31 +0100 Subject: [PATCH] feat: add icons and port steamvr quick start guide from @galister --- content/docs/steamvr/_index.md | 2 ++ content/docs/steamvr/quick-start.md | 47 +++++++++++++++++++++++++++++ data/icons.yml | 2 ++ layouts/shortcodes/icon.html | 2 ++ 4 files changed, 53 insertions(+) create mode 100644 content/docs/steamvr/quick-start.md create mode 100644 data/icons.yml create mode 100644 layouts/shortcodes/icon.html diff --git a/content/docs/steamvr/_index.md b/content/docs/steamvr/_index.md index 1d14e2b..4be8b03 100644 --- a/content/docs/steamvr/_index.md +++ b/content/docs/steamvr/_index.md @@ -5,6 +5,8 @@ title: SteamVR # SteamVR +- [Quick start guide](/docs/steamvr/quick-start) + The de facto standard for anything PCVR, SteamVR runs on Linux. Unfortunately the Linux version is riddled with bugs, missing features and bad performace, so in general it can be a subpar experience. diff --git a/content/docs/steamvr/quick-start.md b/content/docs/steamvr/quick-start.md new file mode 100644 index 0000000..210b9cc --- /dev/null +++ b/content/docs/steamvr/quick-start.md @@ -0,0 +1,47 @@ +--- +weight: 200 +title: Quick Start +--- + +# Getting Started with SteamVR on Linux + +## 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="amd" >}} AMD users: use Mesa 24+ radeonsi, kernel 6.7.3+ if possible, stay away from amdpro. + +## 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. + +Launch Steam and install SteamVR. If it repeatedly nags you about sudo upon launch, you might want to setcap the vrcompositor: + +```bash +sudo setcap CAP_SYS_NICE=eip ~/.local/share/Steam/steamapps/common/SteamVR/bin/linux64/vrcompositor-launcher +``` + +(Default install location on most distros) + +## Setting up your HMD + +**Valve Index, Vive, Vive Pro**: These will work just by plugging in. + +**Vive Pro 2** will need the driver from here: + +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` + +Under the `"steamvr"` section: + +```js +"allowSupersampleFiltering" : false, +"disableAsync" : true, +"enableLinuxVulkanAsync" : false, +``` + +For many games, you might want to turn on "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) diff --git a/data/icons.yml b/data/icons.yml new file mode 100644 index 0000000..89b9068 --- /dev/null +++ b/data/icons.yml @@ -0,0 +1,2 @@ +nvidia: '' +amd: '' diff --git a/layouts/shortcodes/icon.html b/layouts/shortcodes/icon.html new file mode 100644 index 0000000..fd2e8c2 --- /dev/null +++ b/layouts/shortcodes/icon.html @@ -0,0 +1,2 @@ +{{ $icon := index site.Data.icons (lower (.Get "name")) | safeHTML }} +{{ if $icon }}{{ $icon | safeHTML }}{{ else }}🯄{{ end }}