feat: add icons and port steamvr quick start guide from @galister

This commit is contained in:
Gabriele Musco 2024-02-12 13:26:31 +01:00
parent c906ae866b
commit 4af5b84f7b
No known key found for this signature in database
GPG key ID: 1068D795C80E51DE
4 changed files with 53 additions and 0 deletions

View file

@ -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.

View file

@ -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: <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`
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)

2
data/icons.yml Normal file
View file

@ -0,0 +1,2 @@
nvidia: '<svg title="Nvidia" width="16" height="16" version="1.1" viewBox="0 0 8.4665 8.4668" xmlns="http://www.w3.org/2000/svg"><g transform="matrix(.15239 0 0 .15239 -7.6206 -5.7837)"><path d="m70.721 58.321v-3.3127c0.32718-0.02045 0.65436-0.0409 0.98154-0.0409 9.0792-0.28628 15.03 7.8114 15.03 7.8114s-6.4209 8.9156-13.312 8.9156c-0.92019 0-1.8199-0.14314-2.6788-0.42942v-10.061c3.5376 0.42942 4.2533 1.9835 6.3595 5.5211l4.7236-3.967s-3.4558-4.5192-9.2632-4.5192c-0.61346-0.02045-1.2269 0.02045-1.8404 0.08179m0-10.96v4.9486l0.98154-0.06135c12.617-0.42942 20.858 10.347 20.858 10.347s-9.4473 11.492-19.283 11.492c-0.85884 0-1.6972-0.08179-2.5356-0.22494v3.0673c0.69525 0.08179 1.411 0.14314 2.1062 0.14314 9.161 0 15.786-4.6827 22.207-10.204 1.0633 0.85884 5.4189 2.9242 6.3186 3.8239-6.0937 5.1122-20.306 9.2223-28.362 9.2223-0.77705 0-1.5132-0.0409-2.2494-0.12269v4.3147h34.804v-36.746zm0 23.904v2.6174c-8.4657-1.5132-10.817-10.327-10.817-10.327s4.0693-4.4987 10.817-5.2349v2.8628h-0.02045c-3.5376-0.42942-6.3186 2.8833-6.3186 2.8833s1.5745 5.5825 6.3391 7.1979m-15.03-8.0772s5.0099-7.4024 15.05-8.1795v-2.6992c-11.124 0.89974-20.735 10.306-20.735 10.306s5.4393 15.745 20.714 17.177v-2.8628c-11.206-1.3905-15.03-13.741-15.03-13.741z" fill="#76b900"/></g></svg>'
amd: '<svg title="AMD" width="16" height="16" version="1.1" viewBox="0 0 34.798 34.798" xmlns="http://www.w3.org/2000/svg"><g transform="translate(-136.79 35.454)" fill="#f61801"><polygon transform="matrix(.18238 0 0 .18238 25.684 -35.454)" points="800 0 800 189.21 748.03 137.24 748.03 51.981 662.77 51.981 610.8 0"/><polygon transform="matrix(.18238 0 0 .18238 25.684 -35.454)" points="609.2 190.8 684.09 190.8 737.59 137.3 662.71 137.3 662.71 62.397 609.2 115.9"/></g></svg>'

View file

@ -0,0 +1,2 @@
{{ $icon := index site.Data.icons (lower (.Get "name")) | safeHTML }}
{{ if $icon }}{{ $icon | safeHTML }}{{ else }}🯄{{ end }}