Using Omniverse Streaming Client

Installation and Usage

To install the Omniverse Streaming Client on user machines:

  1. From the Omniverse Launcher, select Exchange from the top-level menu bar.

  2. From there, click Omniverse Streaming Client from the left-hand Apps sidebar.

  3. In the detail page of Omniverse Streaming Client, click the Install button.

Once the download completes, and Omniverse Streaming Client is installed, click the Launch button to start the client.

Omniverse Launcher: Streaming Client

When prompted, enter the IP address or URL of the remote machine which is broadcasting to interact with the remote session:

Omniverse Streaming Client interface

Configuration

Server

The remote streaming server uses the omni.kit.livestream.native Extension to broadcast content, as well as receive mouse and keyboard inputs coming from clients.

To enable the Extension, launch any Omniverse application using the following command-line arguments:

  • On Windows:

    1.\kit.bat apps/omni.create.kit ^
    2   --enable omni.services.streaming.manager ^
    3   --enable omni.kit.livestream.native ^
    4   --no-window
    
  • On Linux:

    1./kit.sh apps/omni.create.kit \
    2   --enable omni.services.streaming.manager \
    3   --enable omni.kit.livestream.native \
    4   --no-window \
    5   --allow-root
    

Note

After connecting to a remote instance using the Omniverse Streaming Client, should you wish to increase the scaling factor of the remote session to best match the settings of the client, you may wish to restart the server session and provide a scaling factor using the following setting:

# Default value is set to `1.0`, and can be adjusted for best results:
--/app/window/dpiScaleOverride=1.5

A value of 1.5 indicates a scaling factor of 150% which may be common for Users using 4K monitors. Feel free to adjust the setting to best match your level of comfort.

Should the host be located on the infrastructure of a third-party Cloud provider, it may additionally be required that the following ports be opened, and that firewall rules allow traffic inbound and outbound traffic:

  • TCP: 47995 to 48012

  • TCP: 49000 to 49007

  • TCP: 49100

  • UDP: 47995 to 48012

  • UDP: 49000 to 49007

Client

On Linux, the following packages may be required on machines where the client is installed: libavcodec, libavformat, libavutil. These packages can be installed using the following command:

sudo apt-get install libavcodec57 libavformat57 libavutil55

Windows environments do not require any additional dependencies or configuration, other than ensuring firewall rules do not restrict access to the ports listed above.

Debugging

Client

Should you experience any issues while attempting to connect to a remote server, you may wish to refer to the kit-remote.log file located in the installation directory of the Omniverse Streaming Client.

This location can be accessed from the Omniverse Launcher using the following steps:

  1. From the Omniverse Launcher, select Library from the top-level menu bar.

  2. From there, click Omniverse Streaming Client from the left-hand Apps sidebar.

  3. Click the burger menu next to the Launch button, and select the Settings option.

  4. From the Streaming Client Settings modal dialog, click the folder icon next to the version of the client you were using.

  5. Within the file browser window which should appear, locate the kit-remote.log file and open it in a text editor to gather additional information about the last session.

Server

You may additionally gather additional information on the server-side of the connection by providing the following setting to the Omniverse application hosting the stream: --/app/livestream/logLevel=debug.