Custom Protocol Commands

Launcher supports deep linking which allows using custom URLs to point to specific Launcher screens or run various Launcher commands. Deep linking is built on top of custom protocol URLs that start with omniverse-launcher://. Such links can be used by emails, websites or messages to redirect users back to Launcher, or can be used by system administrators to manage installed apps.

This document describes the list of all available custom protocol commands for Launcher.

Showing a Launcher Screen

Launcher supports omniverse-launcher://navigate command to bring up the main window and open a specific screen there. The screen is specified with the path query parameter, for example:

omniverse-launcher://navigate?path=/news

The list below defines all available screens supported by this command:

Installing Apps

omniverse-launcher://install command can be used to start installing an application. This command requires two query arguments:

Query Arguements

  • slug - the unique name of the installed app or connector.

  • version - the version that needs to be installed.

Example

omniverse-launcher://install?slug=create&version=2020.3.0-rc.14

Enterprise Launcher supports only the path argument that must point to a zip archive downloaded from the enterprise portal.

Uninstalling apps

omniverse-launcher://uninstall command can be used to removed installed apps or connectors. This command requires two query arguments:

  • slug - the unique name of the installed app or connector.

  • version - the version that needs to be uninstalled.

Launching apps

omniverse-launcher://launch command allows users to start the specified application. The launch command will start the app with the specified slug and will use the version that is currently selected by user.

This command requires one query argument:

  • slug - the unique name of the installed app that must be launched.

Example

Starts the current version of Create.

omniverse-launcher://launch?slug=create

Note

Users can change their current app versions in the library settings.

Close the Launcher

omniverse-launcher://exit command can be used to close Launcher. This command requires no query arguments.