Private & Confidential

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 8 Next »

Most of the Igloo Core Service’s settings are managed in the config.json file in its install directory. This is validated when the service is run, so there won’t ever be unused or extra options present in this file. This means that if something is missing, it isn’t supported by the version of the service that you have installed. Settings files from the igloo-cast-sources service can be automatically migrated to this format when installing the Igloo Core Service.

config.json

This section is arranged according to the keys present in config.json. It’ll probably make more sense if you’re looking at a copy of the file; the default is shown at the bottom of this page.

Most settings don’t require the service to be restarted for them to take effect; you’ll generally just need to refresh the browser page that the setting will have an effect on. Anything which is used by the service at start-up is an exception to this; these options are annotated below.

service

Configuration for the service’s backend

  • httpPort (number; default 800)

    • insecure webserver port for all pages provided by the service

    • requires restart

  • httpsPort (number; default 801)

    • secure (HTTPS) webserver port for the same pages. Everything is served on both ports simultaneously.

    • requires restart

  • oscPort (number; default 9003) [requires restart]

    • port that the service listens on for incoming OSC. Needs to match Playback and Igloo Control Panel’s OSC outport ports.

    • requires restart

  • computerName (string; default empty) [requires restart]

    • name for the machine, shown only in ICE Control Panel’s discovery page.

    • requires restart

sources

Configuration for behaviour of the sources app (Sources tab in Igloo Control Panel).

  • ignoreList (array of strings; default ["IGLOOHOME"])

    • list of Capture input names not to show in the Sources app. Change to [] to stop ignoring Igloo Home.

cast

Configuration for keyboard/mouse casting app (Mouse tab in ICE Control Panel).

  • behaviour ("ice" or "web"; default "ice")

    • Destination of keyboard/mouse events from the cast app - ICE or Igloo Web.

    • requires restart

youTube

Configuration for Igloo Control Panel’s YouTube app.
Position/scale are used to position the Capture channel somewhere other than the middle of the screen. The channel’s position is reset whenever a new video is provided (to prevent 16:9 videos appearing initially with 360 settings).

  • captureName (string; default "YouTube")

    • the name of the Capture channel that has been set up to display incoming YouTube videos; the service uses this to tell Capture to set it to max resolution, reset its geometry, etc. at correct times.

    • requires restart

  • scale (number; default 1)

    • default scale for the above Capture channel

    • requires restart

  • position ([number, number]; default [0.5, 0.5])

    • default position for the above Capture channel

    • requires restart

fileBrowser

Configuration for Igloo Web/ICE’s built-in WebView file browser.

  • contentFolderPaths (array of strings; default ["C:\\igloo\\Content\\"])

    • Filepaths that can’t be navigated ‘out of’ using the GUI. These filepaths won’t have the ‘up a directory level’ arrow added to their UI.

    • Paths need to use escaped backslashes as a separator.

icedrop

Configuration for the ICEDrop file-share app

  • directory (string; default "C:\\content\\icedrop") [requires restart]

    • Target directory for file uploads from ICEdrop. No files will be uploaded if this doesn’t exist

    • Paths need to use escaped backslashes as a separator.

    • requires restart

spacewalk

Configuration for spacewalk app URL parameters

  • p (string; default empty)

    • ‘project’ URL parameter provided to any spacewalk instances on pageload

    • updated by the spacewalk app when a user explicitly visits a new project using the bookmarklet

  • env (string; default empty)

    • ‘environment’ URL parameter provided to any spacewalk instances on pageload

    • updated by the spacewalk app when a user explicitly visits a new environment using the bookmarklet

projectorControl

Configuration for projector control capabilities of the backend. Set the target port and desired OSC message(s) here.

  • port (number; default 9016)

    • port for OSC to be sent to when requested

    • requires restart

  • on (array of strings)

    • OSC message(s) to turn projectors on when requested

    • requires restart

  • off (array of strings)

    • OSC message(s) to turn projectors off when requested

    • requires restart

controlPanel

ICE Control Panel browser configuration

  • tabs (array of strings; default ["default"])

    • tab identifiers to display in ICE Control Panel instances connected to this service. Identifiers must be configured; see below

  • apps (array of strings; default ["default"])

    • list of app identifiers to display in ICE Control Panel instances connected to this service. Identifiers must be configured; see below

  • _defaultOverrides (object<BrowserIdentifier, Partial<BrowserDeclaration>)

    • override default properties of pre-set browsers; see below

ICE Control Panel browsers

Tabs and applications shown by ICE Control Panel instances connected to a service are configured by that service. This section describes available pre-set browsers, defaults, and custom browser configuration. See above for the related configuration keys in config.json.

Any configured browser can be used as an app or a tab.

Pre-set browsers

Defaults

The "default" identifier for apps and tabs displays the recommended selection. This can change between versions, so new apps and tabs are automatically shown when using this setting.
Current defaults:

  • Tabs: ["cast", "gameEngine", "apps"]

  • Apps: ["matterport, streetview"]

Custom browser configuration (custom_browsers.json)

coming soon; page will be updated

Overriding pre-set browser properties

coming soon; page will be updated

Default config.json

This is created by the service as required. You don’t need to manually create it, or manually add keys (as explained above)

{
  "service": {
    "httpPort": 800,
    "httpsPort": 801,
    "oscPort": 9003,
    "computerName": ""
  },
  "sources": {
    "ignoreList": ["IGLOOHOME"]
  },
  "cast": {
    "behaviour": "ice"
  },
  "youTube": {
    "captureName": "YouTube",
    "scale": 1,
    "position": [0.5, 0.5]
  },
  "fileBrowser": {
    "contentFolderPaths": ["C:\\igloo\\Content\\"]
  },
  "icedrop": {
    "directory": "C:\\content\\icedrop"
  },
  "spacewalk": {
    "p": "",
    "env": ""
  },
  "projectorControl": {
    "port": 9016,
    "on": ["/deviceControl/projectors/on"],
    "off": ["/deviceControl/projectors/off"]
  },
  "controlPanel": {
    "tabs": ["default"],
    "apps": ["default"],
    "_defaultOverrides": {}
  }
}

  • No labels

(c) Igloo Vision 2020