Hardware #
GPU support matrix #
Manufacturer | Driver | VR Support | Reprojection Support | Hybrid Graphics Support | Notes |
---|---|---|---|---|---|
Nvidia | Nvidia (Closed Source) | Excellent | Excellent | Supported | Requires an implicit vulkan-layer AUR package to not segfault. |
Nvidia | Nouveau (Open Source) | Functional | Functional | Supported | Lacks DisplayPort audio. |
Intel | i915 (Open Source) | Functional | Unknown | Supported | Relatively old, most likely poor support for newer GPUs. |
Intel | Intel/Xe (Open Source) | No wired HMDs | N/A / Unable to drive wired. | Supported | Lacks direct mode implementation in driver, unable to drive wired HMDs. |
AMD | RADV (Open Source) | Excellent | Robust (RDNA+) | Supported | RDNA generation and up supported with compute tunneling for reprojection. Lower than RDNA are not robust. |
AMD | AMDVLK (Open Source) | Use RADV | Use RADV | N/A | RADV preferred in all circumstances, unable to drive wired HMDs. Do not use. Do not seek support. |
AMD | AMDGPU PRO (Closed Source) | Use RADV | Use RADV | N/A | RADV preferred in all circumstances, unable to drive wired HMDs. Do not use. Do not seek support. |
Notes:
- VR Support: Indicates how well supported the necessary Vulkan API components are.
- Reprojection Support: Describes the support and quality of reprojection features for VR. Poor support indicates that the driver is not able to properly handle Vulkan realtime shaders and it will present as visual stutter. Non-robust solutions will suffer stutter under very high GPU load.
- PRIME/ Hybrid GPU Support: Compatibility with systems using multiple GPUs for render offload. Monado and all clients must be run on a single select GPU due to memory tiling requirements.
- For Nvidia proprietary drivers, the vulkan-layer is required not to crash.
- AMD GPUs lower than RDNA generation have functional but less robust reprojection capabilities, expected to be similar to Intel.
- Audio over displayport is known to temporarily cut out when new audio sources spring up on pipewire without a fix to add alsa headroom
- X11 configurations are discouraged but workable, please upgrade your system to Wayland if at all possible.
XR Devices #
A non-comprehensive table of various VR/XR devices and the drivers that support them.
Device | SteamVR | Monado | WiVRn |
---|---|---|---|
PC VR | |||
Valve Index | ✅ | ✅ | 🚧 (WiVRn PC-PC stream) |
HTC Vive | ✅ | ✅ | 🚧 (WiVRn PC-PC stream) |
HTC Vive Pro | ✅ | ✅ | 🚧 (WiVRn PC-PC stream) |
HTC Vive Pro Eye | ✅ (No eyechip) | ✅ (No eyechip) | 🚧 (WiVRn PC-PC stream) |
HTC Vive Pro 2 | ✅ (custom driver and patches) | ✅ (With two kernel patches 1 2 Doesn’t work on Nvidia) | – |
Bigscreen Beyond | ✅ (with kernel patches. Doesn’t work on Nvidia) | ✅ (with kernel patches. Doesn’t work on Nvidia) | – |
Somnium VR1 | ? | ? | ? |
VRgineers XTAL | ? | ? | ? |
StarVR One | ? | ? | ? |
Varjo VR-1 | ? | ? | ? |
Varjo VR-2 | ? | ? | ? |
Varjo VR-3 | ? | ? | ? |
Pimax 4K | ❌ (Planned) | 🚧 (WIP, with kernel patches) | 🚧 (WiVRn PC-PC stream) |
Pimax 5K Plus | ❌ (Planned) | ✅ (WIP, with kernel patches) | 🚧 (WiVRn PC-PC stream) |
Pimax 5K XR | ❌ (Planned) | ✅ (WIP, with kernel patches) | 🚧 (WiVRn PC-PC stream) |
Pimax 5K SUPER | ❌ (Planned) | ✅ (WIP, with kernel patches) | 🚧 (WiVRn PC-PC stream) |
Pimax 8K | ❌ (Planned) | ✅ (WIP, with kernel patches) | 🚧 (WiVRn PC-PC stream) |
Pimax Vision 8K X | ❌ (Planned) | ✅ (WIP, with kernel patches) | 🚧 (WiVRn PC-PC stream) |
Pimax Vision 8K PLUS | ❌ (Planned) | ✅ (WIP, with kernel patches) | 🚧 (WiVRn PC-PC stream) |
Lenovo Explorer | ✅ (Monado SteamVR plugin) | ✅ (experimental 6dof controllers) | 🚧 (WiVRn PC-PC stream) |
Acer AH101 | ✅ (Monado SteamVR plugin) | ✅ (experimental 6dof controllers) | 🚧 (WiVRn PC-PC stream) |
Dell Visor | ✅ (Monado SteamVR plugin) | ✅ (experimental 6dof controllers) | 🚧 (WiVRn PC-PC stream) |
HP WMR headset | ✅ (Monado SteamVR plugin) | ✅ (experimental 6dof controllers) | 🚧 (WiVRn PC-PC stream) |
Samsung Odyssey | ✅ (Monado SteamVR plugin) | ✅ (experimental 6dof controllers) | 🚧 (WiVRn PC-PC stream) |
Asus HC102 | ✅ (Monado SteamVR plugin) | ✅ (experimental 6dof controllers) | 🚧 (WiVRn PC-PC stream) |
Samsung Odyssey+ | ✅ (Monado SteamVR plugin) | ✅ (experimental 6dof controllers) | 🚧 (WiVRn PC-PC stream) |
HP Reverb | ✅ (Monado SteamVR plugin) | ✅ (experimental 6dof controllers) | 🚧 (WiVRn PC-PC stream) |
Acer OJO 500 | ✅ (Monado SteamVR plugin) | ✅ (experimental 6dof controllers) | 🚧 (WiVRn PC-PC stream) |
HP Reverb G2 | ✅ (Monado SteamVR plugin) | ✅ (experimental 6dof controllers) | 🚧 (WiVRn PC-PC stream) |
Oculus Rift CV1 | 🚧 (Monado SteamVR plugin) | 🚧 (ancient openhmd based support) | 🚧 (WiVRn PC-PC stream) |
Oculus Rift S | ✅ (Monado SteamVR plugin) | ✅ (experimental 6dof controllers) | 🚧 (WiVRn PC-PC stream) |
Standalone | |||
Quest | ✅ (via ALVR) | – | ✅ |
Quest 2 | ✅ (via ALVR) | – | ✅ |
Quest Pro | ✅ (via ALVR) | – | ✅ |
Quest 3 | ✅ (via ALVR) | – | ✅ |
Pico 4 | ✅ (via ALVR) | – | ✅ |
Pico Neo 3 | ✅ (via ALVR) | – | ✅ |
HTC Vive Focus 3 | ✅ (via ALVR) | – | ✅ |
HTC Vive XR Elite | ✅ (via ALVR) | – | ✅ |
Lynx R1 | ✅ (via ALVR) | – | ✅ |
Apple Vision Pro | ✅ (via ALVR) | – | ❌ |
Trackers | |||
Vive/Tundra trackers | ✅ | ✅ | 🚧 (WIP) |
SlimeVR trackers | ✅ | ✅ (OSC, driver WIP) | 🚧 (WIP) |
Project Babble | ✅ (oscavmgr) | ✅ (oscavmgr) | ✅ (oscavmgr) |
Eyetrack VR | ✅ | ✅ | ✅ |
Mercury Handtrack | 🚧 (Monado SteamVR plugin, win only) | ✅ (survive driver only) | ❌ |
Lucid VR Gloves | ? | ✅ (survive driver only) | ❌ |
Standable FBT | ❌ | ❌ | ❌ |
Hardware note #
WiVRn PC XR to WiVRn PC client streaming remains mainly for debug use.
Vive Pro microphones should be set to use 44.1khz sample rates as feeding in 48khz raises the pitch of the audio.
Valve index audio output should be set to 48khz or no audio will output.
Vive Pro Eye HMD functional, eyechip WIP.
Pimax initialization code WIP. Distortion matrix dump work in progress.
Eyetrack VR and Project Babble will both be implemented through oscavmgr to emit proper unified flexes over OSC.
Applying a kernel patch (for Vive Pro 2, Bigscreen Beyond, Pimax) #
Arch #
- download the patch(es), then follow the steps on https://wiki.archlinux.org/title/Kernel/Arch_build_system,
which should be roughly:
mkdir ~/build/
->cd ~/build/
->pkgctl repo clone --protocol=https linux
->cd linux
- (section 2 of link) open
PKGBUILD
in that directory and modify thepkgbase
line (at the top) to read e.g. “pkgbase=linux-customvr
”. then add a line containing “<patchfilename>.patch
” to thesource
array:
source=(
https://cdn.kernel.org/pub/linux/kernel/v${pkgver%%.*}.x/${_srcname}.tar.{xz,sign}
<patchfilename>.patch
$url/releases/download/$_srctag/linux-$_srctag.patch.zst{,.sig}
config # the main kernel config file
)
- close
PKGBUILD
. (may not be necessary but i ranupdpkgsums
) ->makepkg -s --skippgpcheck
(i didn’t feel like fixing a pgp error) - then section 4 of https://wiki.archlinux.org/title/Kernel/Arch_build_system#Installing and restart
NixOS #
- download the patch(es)
- add this to your configuration.nix or other nix file you use:
boot.kernelPatches = [
{
name = "type what the patch is for here";
patch = /path/to/patch/file.patch;
}
];
reference commit on my nix files: https://github.com/TayouVR/nixfiles/commit/d6ef568a2642c5a26eb92611be7335afdb6047de