Getting CloudXR#

The NVIDIA CloudXR™ SDK consists of three main components, which are distributed separately:

  • CloudXR Runtime (Server): Download from NGC. An OpenXR-compliant runtime for Windows and Linux servers. Required for all deployments.

  • Apple Clients (Vision Pro, iPhone, iPad):

    • CloudXR Framework: Download from GitHub. A native Swift framework for building visionOS and iOS clients. Required for Apple Vision Pro, iPhone, and iPad support.

    • Foveated Streaming Framework: Available in visionOS. Apple’s first-party framework for dynamic foveated streaming on visionOS, powered by CloudXR technology embedded within visionOS. Required for eye-tracking optimized streaming on Apple Vision Pro.

  • CloudXR.js (Web clients): Download from NGC. A JavaScript framework for building web-based XR clients. Required for Meta Quest, Pico, and browser-based experiences.

Additionally, there is a Stream Manager service that you can use to manage CloudXR Runtime instances, and many Sample Applications are available to help you get started.

CloudXR Runtime#

CloudXR Runtime is distributed through NVIDIA NGC (NVIDIA GPU Cloud).

To download:

  1. Go to the CloudXR Runtime page on NGC.

  2. (Optionally) Sign in with your NVIDIA Developer account.

  3. Click Download and select your platform:

    • On Windows, download CloudXR-<version>-Win64-sdk.zip

    • On Linux, download CloudXR-<version>-Linux-sdk.tar.gz

To get started: Refer to CloudXR Runtime for detailed instructions, or follow the LÖVR CloudXR sample for a quick start.

CloudXR Framework#

CloudXR Framework is distributed as an open-source Swift package on GitHub.

To add CloudXR Framework to Your Xcode Project:

  1. In Xcode, go to File → Add Package Dependencies.

  2. Enter the repository URL: https://github.com/NVIDIA/cloudxr-framework.

  3. Select the latest version.

  4. Add the package to your project targets.

To get started: Refer to CloudXR Framework for detailed instructions, or follow the CloudXR Framework tutorial for a quick start.

Foveated Streaming Framework#

Foveated Streaming Framework is a first-party API in visionOS that wraps CloudXR technology embedded within the operating system. It enables dynamic foveated streaming to Apple Vision Pro in a secure and privacy-preserving fashion.

To add Foveated Streaming Framework to Your Xcode Project:

  1. In Xcode, add import FoveatedStreaming to your Swift source file.

Note

Foveated Streaming is a system framework built into visionOS 26.4 and later. There is no separate download required. The framework is automatically available when targeting visionOS 26.4+.

To get started: Refer to Foveated Streaming Framework for detailed instructions, or follow the Foveated Streaming tutorial for a quick start.

For more information, see the Apple Foveated Streaming documentation.

CloudXR.js#

CloudXR.js is distributed through NVIDIA NGC as an npm package tarball.

To download from NGC:

  1. Go to the CloudXR.js page on NGC.

  2. (Optionally) Sign in with your NVIDIA Developer account.

  3. Download the npm package tarball: nvidia-cloudxr-<version>.tgz.

To get started: Refer to CloudXR.js for detailed instructions, or follow the CloudXR.js tutorial for a quick start.

Stream Manager (Optional)#

Stream Manager is a Windows service for managing CloudXR Runtime instances.

To download:

  1. Go to the Stream Manager page on NGC.

  2. Download the Windows package: Stream-Manager-<version>-win64.zip.

  3. Extract to your desired location.

To get started: Refer to Stream Manager for detailed instructions.

Sample Applications#

LÖVR CloudXR Sample#

The LÖVR sample is a lightweight OpenXR application that’s ideal for testing your CloudXR deployment.

We strongly recommend this sample as your first server application before moving to larger custom OpenXR applications or game-engine integrations.

Generic Viewer (Apple)#

Generic Viewer is a complete reference client for Apple platforms.

See Samples Overview for all available samples.

Next Steps#

After you download CloudXR components:

  1. Start with the Quick Start Guide: Quick Start Guide provides a practical workflow for getting your first deployment streaming.

  2. Review Requirements: Ensure your hardware and network meet the specifications: