Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.liv.tv/llms.txt

Use this file to discover all available pages before exploring further.

LIV uses the registry to store a few helpful paths for locating and interacting with a LIV installation. All registry keys are stored under the 64-bit Current User hive, in the location: 
HKEY_CURRENT_USER\SOFTWARE\LIV.App
Stored here are the following keys:
KeyTypePurpose
BaseDirectoryStringPath to LIV’s main directory.
ExecutableStringPath to LIV’s main executable.
SDKRuntimePathStringPath to the LIV SDK’s runtime directory.
ExternalApplicationsSub-keyA list of external applications compatible with LIV.
They are updated whenever LIV is opened. You can use the BaseDirectory path along with LIV.App.CommandLine.exe for easy access to the command-line API!

​
ExternalApplications

If you’ve integrated the LIV SDK, but are not distributing through Steam, Meta Quest App Store, NetVios, or Viveport, you may add an entry to this sub-key and LIV will attempt to detect, launch, and automatically capture your app. The format for these entries is described below, in JSON - this directly translates to the structure in the registry. 
"ExternalApplications": {

  // An opaque string identifier for your application.
  "custom-app-id": {

    // User-visible name.
    "Name": "My Custom Application",

    // The app's install folder. Used to detect game engine & SDK version.
    "InstallPath": "C:\Path\To\App",

    "Executable": "C:\Path\To\App\Executable.exe",
    "Arguments": "-your -options -here",
    "WorkingDirectory": "C:\Path\To\App" // Optional.
  }
}
Registry It is best practice, if you are adding your application to this list, to proactively update the values stored in the registry whenever your application is installed, run, or uninstalled. If LIV cannot find the executable, or install path, it will not be added to LIV’s capture list. Additionally, if LIV cannot find the LIV SDK in the install path, it will not be added. Changes to the registry are not live. You need to restart LIV for any changes to apply.