diff --git a/content/docs/fossvr/wivrn/_index.md b/content/docs/fossvr/wivrn/_index.md index 6a812bb..c4bd957 100644 --- a/content/docs/fossvr/wivrn/_index.md +++ b/content/docs/fossvr/wivrn/_index.md @@ -15,9 +15,26 @@ WiVRn is based on [Monado](/docs/fossvr/monado/) and can be used with [OpenCompo ## Installing WiVRn -We recommend using [Envision](/docs/fossvr/envision/) to install and launch WiVRn & OpenComposite. Envision will handle all configuration seamlessly and avoids many of the pitfalls of a manual setup. +We recommend using distribution packages when available or the [WiVRn Flatpak](https://flathub.org/apps/io.github.wivrn.wivrn). -Alternatively, you can use the [WiVRn Flatpak](https://flathub.org/apps/io.github.wivrn.wivrn) which includes OpenComposite as part of it. Processes in Flatpak cannot take advantage of setcap, and so your performance may suffer when compared to Envision. +### Arch Linux + +Packages are available on [AUR](https://wiki.archlinux.org/title/Arch_User_Repository), you will need the following packages: + +* `wivrn-server` and `wivrn-dashboard` for base feature + GUI (latest release), or `wivrn-full-git` for development version +* `opencomposite-git` or `xrizer-git` for compatibility with OpenVR and proton + +### Gentoo Linux + +Packages are available on [Guru](https://wiki.gentoo.org/wiki/Project:GURU), you will need `media-libs/wivrn` and `media-libs/opencomposite` + +### Flatpak (all distributions) + +The [WiVRn Flatpak](https://flathub.org/apps/io.github.wivrn.wivrn) has the latest released version. For development releases, you can download the `wivrn-flatpak-x86_64` artifact from Github [Build](https://github.com/WiVRn/WiVRn/actions/workflows/Build.yml?query=branch%3Amaster) action + +### Envision (guided build) + +You can use [Envision](/docs/fossvr/envision/) to install and launch WiVRn & OpenComposite. ## General WiVRn Notes @@ -25,7 +42,7 @@ WiVRn uses Avahi for network discovery. Ensure it is running with the following ```bash systemctl enable --now avahi-daemon ``` -(If Avahi is not available, the IP address of the server must be entered into the client.) +If Avahi is not available, `--no-publish-service` bypasses it, and the IP address of the server must be entered into the client. If a firewall is installed, make sure ports 5353/UDP and 9757/UDP+TCP are open for Avahi and WiVRn itself, respectively. @@ -52,8 +69,6 @@ flatpak override --user --env=PRESSURE_VESSEL_FILESYSTEMS_RW=/run/user/1000/wivr You can use WiVRn with a cable instead of Wi-Fi. Use a 5Gbps cable & port at the very least. -WiVRn version: 0.19+ - Using Envision: - Connect the headset via USB. - In Envision, click the `Start WiVRn Client (Wired)` button.