matrixfurry.com
The open source OpenXR runtime
1# How to use the remote driver {#howto-remote-driver}
2
3<!--
4Copyright 2022, Collabora, Ltd. and the Monado contributors
5SPDX-License-Identifier: BSL-1.0
6-->
7
8## Prerequisites
9
10Before proceeding you will need to have monado installed (or built) and capable
11of running applications. If you do not have any hardware this should still work
12with the simulated driver. For those building Monado themselves you have to make
13sure the GUI is built. In short the commands `monado-gui` and `monado-service`
14are needed.
15
16## Running
17
18Open up three terminals and in the first run this command:
19
20```bash
21P_OVERRIDE_ACTIVE_CONFIG="remote" <path-to>/monado-serivce
22```
23
24If you get a error saying `ERROR [u_config_json_get_remote_port] No remote node`
25you can safely ignore that. Once it is up and running you can now start and
26connect the controller GUI. Select the second terminal use the command below and
27click connect.
28
29```bash
30monado-gui remote
31```
32
33You can now launch the program. You technically don't need to launch the
34program after @p monado-gui, once the service is running they can be launched
35in any order.
36
37```bash
38hello_xr -G Vulkan2
39```
40
41Now you can manipulate the values and control the devices.