From d5a2888b39cd3ec9ea1e167a0b5d72874d5a9453 Mon Sep 17 00:00:00 2001
From: galister <3123227-galister@users.noreply.gitlab.com>
Date: Sat, 16 Aug 2025 07:57:37 +0000
Subject: [PATCH] wmr: forcing nvidia display

---
 .../envision/wmr_controllers_on_arch.md       | 50 +++++++++++--------
 1 file changed, 30 insertions(+), 20 deletions(-)

diff --git a/content/docs/fossvr/envision/wmr_controllers_on_arch.md b/content/docs/fossvr/envision/wmr_controllers_on_arch.md
index bb9cdf4..f85f03c 100644
--- a/content/docs/fossvr/envision/wmr_controllers_on_arch.md
+++ b/content/docs/fossvr/envision/wmr_controllers_on_arch.md
@@ -5,6 +5,8 @@ title: WMR Controller Tracking on Arch
 
 # Envision Installation on Arch with Controller Tracking
 
+## Install Envision-XR with Paru on Arch
+
 ## Recommendations:
 - **Paru** as the Arch AUR helper
 - **KDE** as the desktop environment for better compatibility with SteamVR (may not be necessary)
@@ -18,31 +20,15 @@ cd paru
 makepkg -si
 ```
 
-## Monado Vulkan Layers
-These are only needed if you have an NVIDIA Card and a Nvidia Driver before 565.77.01.
-
-[Monado Vulkan Layers AUR](https://aur.archlinux.org/packages/monado-vulkan-layers-git)
-### Paru Installation
-```bash
-paru -S monado-vulkan-layers-git
-```
-### Normal Installation with compiling manually
-```bash
-git clone https://aur.archlinux.org/monado-vulkan-layers-git.git
-cd monado-vulkan-layers-git
-makepkg -i
-```
-- -> Install dependencies and, if needed, run `makepkg -i` again.
-
-## Envision-XR with Paru
+### Install Envision-XR from AUR using Paru:
 [Envision-XR AUR](https://aur.archlinux.org/packages/envision-xr-git)
 ```bash
 paru -S envision-xr-git
 ```
 
+## Envision Configuration <small>(Non-Arch users follow from here!)</small>
 
-### Envision Setup
-- Select **WMR default**.
+- Select profile: **WMR default**.
 
 ![WMR default](/images/EnvisionXR_WMR.png "Envision XR Screen with WMR Envision Default selected")
 - Duplicate and adjust settings:
@@ -75,4 +61,28 @@ paru -S envision-xr-git
     WARN [wmr_controller_send_fw_cmd] Controller fw read timed out after 250 ms
     ERROR [wmr_bt_controller_create] WMR Controller (Bluetooth): Failed to create controller
     ERROR [wmr_create_bt_controller] Failed to create WMR controller (Bluetooth)
-    ```
\ No newline at end of file
+    ```
+
+### Troubleshooting
+
+#### NVIDIA: No allowlisted displays found!
+
+1. See the logs:
+
+  ```
+    == Current Allowlist (8) ==
+        Sony SIE  HMD *08
+        HTC Corporation HTC-VIVE
+        HTC Corporation VIVE Pro
+        Oculus VR Inc. Rift
+        Valve Corporation Index HMD
+        Seiko/Epson SEC144A
+        HPN
+        PNP
+    == Found Displays (2) ==
+        SAMSUNG (HDMI-0)
+        HP Inc. (DP-2)
+  ```
+2. Identify which entry under Found Displays is your HMD.
+3. Add the following env var to the Envision profile, with the correct name for your HMD:
+  `XRT_COMPOSITOR_FORCE_NVIDIA_DISPLAY="HP Inc."`
\ No newline at end of file