Skip to content

Home

Jump to bottom
Matthieu Bucchianeri edited this page Oct 23, 2023 · 76 revisions

Welcome to the VirtualDesktopXR wiki!

VirtualDesktopXR (VDXR) is an implementation of the OpenXR standard for Virtual Desktop on Windows. It allows you to run OpenXR applications without SteamVR.

DISCLAIMER: This software is distributed as-is, without any warranties or conditions of any kind. Use at your own risks.

Table of Contents
  1. Compatibility
  2. Setup
  3. Troubleshooting
  4. Donate

Compatibility

See the Application Compatibility page.

Setup

VERY IMPORTANT NOTE

There are two version of VirtualDesktopXR, with very important differences to understand:

  • The version bundled with Virtual Desktop. This version is installed as part of Virtual Desktop since version 1.29.3. It is the preferred way to get and use VirtualDesktopXR. This version is fully integrated with Virtual Desktop and can be activated through the Virtual Desktop settings. This version supports Virtual Desktop and all the devices that it works with (Quest, Pico) and nothing else.

    image

  • The Standalone version. This version may be installed separately from Virtual Desktop. It is not as integrated as the bundled version and is not recommended for beginners. The key feature of the Standalone version is that it can also be used with Oculus Link (without Virtual Desktop) as a replacement of the Oculus OpenXR runtime.

Note that the Standalone version is currently not available and should be released by the end of November 2023.  

Download & installation

VirtualDesktopXR is currently available through the Virtual Desktop BETA.

For Oculus users

To install the beta version, navigate to the store page of Virtual Desktop on the Meta website or phone app. Scroll down to the version number, click it and select the BETA channel. You will also need to manually install the Beta Streamer.

image

For Pico users

You can install this Beta by installing the APK from the GitHub page. You will also need to manually install the Beta Streamer.

image

Is it working?

If all went well, you can check if an application is using VirtualDesktopXR by bringing up the Virtual Desktop performance overlay and look for the 'Runtime'. If the value reads 'VDXR', then it means the application is using VirtualDesktopXR.

image

Troubleshooting

  • Make sure VirtualDesktopXR is selected as the OpenXR runtime in the Virtual Desktop settings.

    image

  • Make sure your application uses OpenXR! Supporting OpenXR is a decision made by the developers of each application. It is not something you can force an application to do if that application was not developed for OpenXR. There is no universal way to tell whether an application can use OpenXR, see the Application Compatibility page for more information.

  • If none of the above helped, you can file an issue or join our Discord to ask for support.

IF YOU DON'T INCLUDE YOUR LOG FILE AND A CLEAR EXPLANATION OF YOUR ISSUE, YOUR MESSAGE WILL BE IGNORED.

Log file can be found under the %ProgramData%\Virtual Desktop folder and is named OpenXR.log. You can copy this string into your File Explorer to be taken directly to the correct folder!

Donate

Donations are welcome and totally optional. Please use my GitHub sponsorship page to make one-time or recurring donations!

Thank you!

Clone this wiki locally