XR + Holoviz #

Authors: Connor Smith (NVIDIA), Rafael Wiltz (NVIDIA), Mimi Liao (NVIDIA)
Supported platforms: x86_64
Language: C++
Last modified: May 13, 2025
Latest version: 1.0.0
Minimum Holoscan SDK version: 3.1.0
Tested Holoscan SDK versions: 3.1.0
Contribution metric: Level 4 - Experimental

This application demonstrates the integration of Holoscan-XR with Holoviz for extended reality visualization.

Quick Start Guide#

1. Build the Docker Image#

Run the following command in the top-level HoloHub directory:

./dev_container build --docker_file ./applications/xr_holoviz/Dockerfile --img holohub:xr_holoviz

2. Run the application#

Terminal 1: Launch Container and Start Monado Service#

# Launch the container
./dev_container launch --img holohub:xr_holoviz

# Inside the container, start the Monado service
monado-service

Keep this terminal open and running.

Terminal 2: Build and Run the Application#

# Enter the same container (replace <container_id> with actual ID from 'docker ps')
docker exec -it <container_id> bash

# Build the application
./run build xr_holoviz

# Run the application
./run launch xr_holoviz

Set up width and height correctly#

The width and height of the HolovizOp should be set to the width and height of the XR display, which can only be obtained during runtime. To set the width and height correctly, we need to:

Run the application

Find the log showing

XrCompositionLayerManager initialized width: XXX height: YYY

Copy the width and height
Set the width and height of the HolovizOp in config.yaml

XR + Holoviz#