Merge branch lvra.gitlab.io:main into main

This commit is contained in:
Etch9 2025-05-25 13:52:55 +00:00
commit 79b97a4f68
7 changed files with 57 additions and 23 deletions

View file

@ -12,4 +12,6 @@ Feel free to contribute to this wiki yourself if you find anything useful that y
You can start with the [hardware table](/docs/hardware/).
After which you may want to take a look at the [Envision](/docs/fossvr/envision/) application for quick setup and compatibility with your PC Steam games.
For wireless/android/standalone headsets visit the [WiVRn](/docs/fossvr/wivrn/) page for installation instructions.
For wired headsets similar to Valve Lighthouse/WMR/Oculus/Rift use [Envision](/docs/fossvr/envision/) application for quick setup and compatibility with your PC Steam games.

View file

@ -6,33 +6,26 @@ title: Void Linux
## Envision
The [official Appimage](https://gitlab.com/gabmus/envision#download-envision) is the easiest way to get Envision working on Void Linux.
Just make sure you have all necessary dependencies installed for building your desired profile.
Envision will warn you if some are missing.
Except for OpenXR these are standard packages which can be found in the Void repositories, you may need `-devel` for some packages like `libbsd-devel` for example.
Getting OpenXR can be a bit tricky, but you can follow the instructions for installing OpenXR on this page to get you started.
The [official Appimage](https://gitlab.com/gabmus/envision#download-envision)
is the easiest way to get Envision working on Void Linux.
## Installing OpenXR
Just make sure you have all necessary dependencies installed for building your
desired profile. For Monado, all of the dependencies can be found in the Void
repositories - see the following section [Building Monado](#building-monado)
for the full list.
As of writing (April 2025) OpenXR is not available in the Void Linux repositories, you can however build and install it yourself using `xbps-src`.
There is a pending PR over on the void-packages Github page: https://github.com/void-linux/void-packages/pull/54896.
In the meantime you can use the OpenXR template from the PR to build and install OpenXR locally.
Just clone the void-packages repo with the OpenXR template and install using the following steps from within the root dir:
```bash
./xbps-src binary-bootstrap
./xbps-src pkg openxr
xi openxr openxr-devel
```
Envision may warn you about other missing dependencies. They can usually be
found in the Void repositories; you may also need `-devel` for some packages,
for example: `libbsd-devel`
## Building Monado
Monado may appear to build fine but if you are missing some dependencies only the null compositor will work.
To make a successful build make sure you have the following dependencies installed:
Monado may appear to build fine but if you are missing some dependencies only
the null compositor will work. To make a successful build make sure you have
the following dependencies installed:
```bash
sudo xbps-install pkg-config python3 wayland-devel glslang vulkan-loader-devel libglvnd-devel eigen libusb-devel eudev-libudev-devel v4l-utils-devel libxcb-devel wayland-devel libX11-devel hidapi-devel libopencv-devel libjpeg-turbo-devel libbluetooth-devel SDL2-devel cJSON-devel gstreamer1-devel gst-plugins-base1-devel
sudo xbps-install pkg-config python3 wayland-devel glslang vulkan-loader-devel libglvnd-devel eigen libusb-devel eudev-libudev-devel v4l-utils-devel libxcb-devel wayland-devel libX11-devel hidapi-devel libopencv-devel libjpeg-turbo-devel libbluetooth-devel SDL2-devel cJSON-devel gstreamer1-devel gst-plugins-base1-devel libbsd-devel openxr-devel
```
There is another [PR](https://github.com/void-linux/void-packages/pull/53279) with templates for xrgears, Monado and libsurvive that you can use, however it is easier and recommended to just use Envision to build everything for you.
There is a [void-packages PR](https://github.com/void-linux/void-packages/pull/53279) with templates for xrgears, Monado and libsurvive that you can use, however it is easier and recommended to just use Envision to build everything for you.

View file

@ -128,3 +128,9 @@ The Oculus Rift CV1 is supported on the OpenHMD profile of Envision.
Start the profile with your headset placed on the floor in clear view of all bases to generate this file as your calibrated playspace origin first run and delete it to reset the configuration.
A calibration of base stations will be saved to disk at `~/.config/openhmd/rift-room-config.json`.
### Fix View
In Steam OpenVR games, the eye's are not calibrated properly, and result in double vision or cross eye effect.
You can add "OXR_PARALLEL_VIEWS=1 %command%" to the launch options to fix this.

View file

@ -33,6 +33,12 @@ In order to use the SteamVR lighthouse driver in Monado, you just need to set th
OpenComposite is REQUIRED to operate Monado in conjunction with Steam games. Proton requires a functional OpenVR API to utilize OpenXR at all and Proton itself is required for VR to function as normal wine does not carry any of the needed patches nor does "protonified" wine something like Lutris would provide.
### Fix View
In Steam OpenVR games, the eye's are not calibrated properly, and result in double vision or cross eye effect.
You can add "OXR_PARALLEL_VIEWS=1 %command%" to the launch options to fix this.
## Envision
[Envision](/docs/fossvr/envision/) provides a fairly low-barrier setup and development of both Monado and OpenComposite on most any modern distro.

View file

@ -23,6 +23,13 @@ Prepending `OXR_VIEWPORT_SCALE_PERCENTAGE=60` to the game's launch options can g
While in VR, if you have mods that add extra items in the main menu, they will be rotated at an odd angle as well as any UIs.
### Immediate crash with Proton 9+
Currently, Proton 9 and above has an issue ([#8409](https://github.com/ValveSoftware/Proton/issues/8409)) causing NomaiVR to instantly crash on startup, only rendering the game window for a split second.\
The workaround is to just use Proton 8.
Do note that as Proton GE-RTSP is using the latest releases of Proton upstream, it will also not work until this issue is patched.
### Default Quest/Pico 4 controller bindings only partially work with XRizer
When playing the game with XRizer and you use Quest or Pico 4 Controllers, it is recommended to use [this custom bindings file](https://github.com/user-attachments/files/19900420/oculustouch.json) ([more info here](https://github.com/Raicuparta/nomai-vr/issues/558#issue-3018649448)).

View file

@ -93,6 +93,7 @@ A non-comprehensive table of various VR/XR devices and the drivers that support
| Lucid VR Gloves | ? | ✅ (survive driver only) | ❌ |
| Kinect FBT | ✅ | ✅ (experimental) | 🚧 |
| Standable FBT | ❌ | ❌ | ❌ |
| Razer Hydra | ✅ (Monado SteamVR plugin) | ✅ | ❌ |
## Hardware note

View file

@ -13,7 +13,8 @@ weight: 50
The current recommended Proton variant is [**GE-Proton-RTSP**](https://github.com/SpookySkeletons/proton-ge-rtsp/releases).
[OpenComposite](https://lvra.gitlab.io/docs/fossvr/opencomposite/) should now provide a close-to-flawless experience on most controllers and when using hand tracking.
[XRizer](/docs/fossvr/xrizer/) should now provide a close-to-flawless experience on most controllers and when using hand tracking. If you encounter any major issues you can fallback to [OpenComposite](/docs/fossvr/opencomposite/).
## Visual bugs
@ -27,6 +28,10 @@ To solve this, prepend `OXR_PARALLEL_VIEWS=1` to Resonite's launch options.
## Performance
Resonite currently runs under an extremely old version of Mono runtime required by Unity, which has very poor Garbage Collection causing frequent lag spikes and frame hitching during asset loading and unloading. Very soon, Resonite will be updated to use .NET 9, a far more modern and bespoke runtime, with Unity running on a separate thread only for rendering the game. Eventually Unity will be replaced by a custom rendering engine as well.
The main developer and owner of Resonite goes into more detail [here](https://youtu.be/9cx2-VtL_LM&t=16).
In larger sessions Resonite is typically CPU-bound, there isn't much that can be done besides upgrading your CPU. In situations where the GPU is a bottleneck, lowering the resolution <!-- TODO link to resolution scaling --> (either in the OpenXR runtime or through OpenComposite) may help dramatically.
This can be easily done by prepending `OXR_VIEWPORT_SCALE_PERCENTAGE=75` to Resonite's launch options. Experiment with different values to find your preferred balance between performance and quality.
@ -46,6 +51,20 @@ You can load RML mods with MonkeyLoader but not the other way around.
The exact cause of this is currently unknown. Consider using MonkeyLoader if you encounter such issues starting the game as it seems to not cause the same problem.
### ResonitePlatformSpoof
- [Mod Repo](https://github.com/isovel/ResonitePlatformSpoof)
- [Link to working version](https://github.com/isovel/ResonitePlatformSpoof/issues/2#issuecomment-2439588723)
{{% hint info %}}
See [issue #2745](https://github.com/Yellow-Dog-Man/Resonite-Issues/issues/2745#issuecomment-2573574108) for more context as to why the Linux badge isn't available for Proton users.
{{% /hint %}}
When the native Linux build of Resonite was still available, players are given a Linux badge to show others that they are running the native build of the client. When Proton is used to play the windows build of the game, you will not get the Linux badge. However, ResonitePlatformSpoof lets you 'spoof' your platform to the Linux native build and allows proton users to get the Linux badge.
## Crashes
Resonite has been seen causing random SteamVR crashes on Linux before. In some situations the engine also tends to freeze. On OpenComposite, the game will rarely close out on its own without leaving any obvious trace of things going wrong &mdash; this is being investigated.