Skip to content

XR + Holoviz#

Authors: Connor Smith (NVIDIA), Rafael Wiltz (NVIDIA), Mimi Liao (NVIDIA)
Supported platforms: x86_64
Language: C++
Last modified: July 1, 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: 

./holohub build-container xr_holoviz

2. Run the application#

Terminal 1: Launch Container and Start Monado Service#

# Launch the container and start the Monado service
./holohub run-container --img holohub:xr_holoviz -- 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 and run the application
./holohub run 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:

  1. Run the application
  2. Find the log showing 
    XrCompositionLayerManager initialized width: XXX height: YYY
  3. Copy the width and height
  4. Set the width and height of the HolovizOp in config.yaml