Skip to main content
Version: 20 Mar 2024

Remote Render Setup

Magic Leap Remote Rendering is a first-party tool, created by Magic Leap, designed to allow for rendering content onto a Magic Leap 2 device from a more-powerful, non-mobile Windows computer.

Prerequisites​

System Requirements​

Minimum
OSWindows 10+
CPUIntel i7 / AMD Ryzen
CPU Cores4
RAM16GB
VRAM6GB
GPUNVIDIA GPU
NVIDIA driverversion 495 or later*
Bandwidth100Mbps WiFi 5
note

* Run nvidia-smi.exe in a command prompt to get the NVIDIA Driver Version. Remote rendering will not work without an NVIDIA GPU.

Installing Remote Render​

  1. Download the Magic Leap Remote Rendering package from the Package Manager within the Magic Leap Hub.

  2. Make sure your device is connected to the same network as your computer before continuing. You need to connect via USB or WiFi Bridge to install the Remote Viewer on your headset. (If you've never used WiFi Bridge, you need to connect with USB first, and then switch over to WiFi Bridge.)

  3. If you don't see the Remote Rendering (Preview) tile, you need to install it. If you already have the tile it's recommended that you ensure you have the latest version of Remote Rendering. If you do, you can skip ahead to step 11. Otherwise, search the tiles for Package Manager and click on it.

  4. Click All and use the search bar at the top of the page to look for Remote Rendering. Under the Package Name column, you should get back the choice to install Magic Leap Remote Rendering.

    Find Remote Rendering Installation Package

  5. Click the downward pointing black arrow to the right of Magic Leap Remote Rendering. You might have to maximize the window to see it, or scroll to the right.

  6. You are prompted with instructions to review and accept a software licensing agreement. Review the agreement, and accept it to continue with the download. Your download will appear with a status like Pending Install.

  7. Next, you'll see the Change Summary panel. All the options for your change are listed. This package only has one item to install, so leave everything as-is. At the bottom of the panel, click Apply Changes to start installation.

    Apply Changes

  8. Walk through the installation wizard for Remote Rendering. You'll be prompted to accept another software agreement, choose a destination folder (leave the default as set), a start menu folder, and finally, install. When the installation completes, click Finish to close the wizard.

  9. In the Magic Leap Hub, you'll still be on the Change Summary screen. If everything went as planned, you see the status of Remote Rendering listed as Installed. In the top right of the screen, click Close Summary.

  10. Navigate back to the home screen. Remote Rendering (Preview) should be the first tile you see, as you just installed it. Before proceeding, make sure your headset is connected to the same network as your computer.

  11. Click Launch on the Remote Rendering (Preview) tile from the Magic Leap Hub home screen.

    Remote Render Tile

note

You must have your Magic Leap headset on and connected to the same network as your computer. The Remote Viewer app needs to be installed. If you don't have it, you meet system requirements, and your device is connected via the device bridge (WiFi or USB), you're prompted to install it. The prompt displays a clickable button that says Install now. If your device is not connected to the device bridge, or if you don't meet system requirements, then you get a note saying you need to have Remote Viewer, but no option to install.

  1. If your system meets requirements for remote rendering, and it's your first time using this tool, when you get the prompt to install Remote Viewer, click Install now.
    Install Remote Viewer
  2. Next, a prompt asks you to install the Client APK. Click Yes, Install.
Install Client APK

  1. When installation completes, you see a QR code prompt labeled Get Started. Put on the Magic Leap 2 and using your controller, open the QR Reader.

  2. Scan the QR code on your headset by looking at it.

    QR Code for Remote Render

  3. The QR code launches a screen on your headset showing the link it's connecting to, and prompts you to open the link with Remote Viewer. Click Continue.

  4. You receive a prompt asking whether you want to allow Remote Viewer to track your eyes and detect gaze behaviors like blinks and fixation and one asking whether to allow Remote Viewer to detect planes and mesh data from the environment around you. For each one, click Allow.

  5. After you successfully pair your Magic Leap 2 with your host PC, you get a notification stating that the app is waiting to be granted permissions, and then a notification indicating that the headset is waiting for the app to start. You can now start an OpenXR app on your host PC.

  6. (Optional) To open a demo OpenXR app on your host PC, go into the Magic Leap Hub on the Remote Rendering screen, and click the Remote Rendering dropdown menu in the upper left corner.

  7. (Optional) From the dropdown, click OpenXR demo app. The demo launches two places. On your PC, the app launches in its own window and shows a view of your headset, controller, and hands. In your headset, you see a banner that says 'Magic Leap Remote Rendering.' You can squeeze the trigger on your controller to play a sound. When you are done trying the app, click the Home button on your controller to exit, and close the app window on your PC.

Device Streaming​

Prevent Feedback Noise​

The Remote Rendering functionality can be used in combination with Device Stream to preview and save what the user sees, however this may cause some audio feedback noise because the audio produced on the host is sent to the device and then back to the host by Device Stream. To prevent audio loopback noise, lower the volume of the Device Stream live preview before starting Remote Rendering.

Troubleshooting​

Fast User Switching​

Magic Leap does not support the Windows OS feature fast user switching for remote rendering. Make sure you are only logged into one account when using remote rendering, or you will get an error message.

Can't Install Remote Viewer​

If your system does not have an NVIDIA GPU, you can't use the remote render feature. The system will not automatically install Remote Viewer if this is the case. Try using a computer with an NVIDIA GPU.

Debug Logs​

If an issue occurs with the Remote Rendering service, logs will be requested for support purposes. To receive these logs, in a PowerShell window, execute the following:

powershell.exe -ExecutionPolicy Bypass -File "C:\Program Files\Magic Leap Remote Rendering\DebuggerScript.ps1"

The logs will be saved, by default to:

%USERPROFILE%\AppData\Roaming\MagicLeap\Windrunner\logs