Solstice User App Defaults on macOS

Core foundation preferences (CFPreferences) for the Mersive Solstice app on a Mac computer can be configured using the Settings section of the app or by configuring a plist (property list) using the macOS command line utility defaults.

Mersive Solstice App Settings for macOS

The following application options can be set using the defaults utility.

Both the Mersive Solstice app and defaults write to the plist. If a user changes a setting in the application, a value that was set using defaults may be overwritten, and vice versa. See the Examples section for more on how changes to the plist affect in-app settings.

Option Type Description
PROFILE/AUTOSHAREDESKTOP Bool

If set to TRUE, the Quick Share Desktop setting is turned on, enabling Solstice to automatically share the user's desktop as soon as they connect to a Solstice display.

PROFILE/AUTOSHAREAUDIO

Bool

If set to TRUE, the Auto Share Audio setting is turned on, enabling Solstice to automatically stream audio to the Solstice display when the user shares their desktop or an application window. (Equivalent to PROFILE/AUTOSHAREAUDIOWITHDESKTOP for Mersive Solstice app version 5.4 and earlier.)

PROFILE/CALENDAR_CONFIG/REFRESH_TOKEN Bool

If set to TRUE, a Microsoft 365 calendar has been integrated with the Mersive Solstice app. Set the value to FALSE to terminate the calendar integration. Calendar integration must be configured in the Conference settings of the app to authenticate with Microsoft 365.

PROFILE/CPUWARNINGCHECKCOUNT Uint32

Reserved.

PROFILE/CPUWARNINGCHECKINTERVALMS Uint32

Reserved.

PROFILE/CPUWARNINGFAILPERCENTAGE Uint32

Reserved.

PROFILE/CPUWARNINGTOTALUSAGETHRESHOLD Uint32

Reserved.

PROFILE/HIDEUIWHENSHARING Bool

If set to TRUE, the Hide Desktop on Share setting is turned on, which hides the app window when the user shares their desktop.

PROFILE/ISFIRSTRUN Bool

When the Mersive Solstice app is first installed, this option is set to TRUE. This causes the app to start with a "get started" screen that prompts the user to enter a profile name. After the app is first run, this value will be set to FALSE.

PROFILE/ISFIRSTTIMEINMINUI Bool

When the Mersive Solstice app is first installed, this option is set to TRUE. This causes the app to display a "got it" prompt the first time the application window is automatically hidden or minimized. (See PROFILE/HIDEUIWHENSHARING.) After the app is first run, this value is set to FALSE.

PROFILE/ISFIRSTWALKTHROUGHRUN Bool

When the Mersive Solstice app is first installed, this option is set to TRUE. This causes the app to display a "walk through" animation about how to use the app to connect to a Solstice display. After the app is first run, this value is set to FALSE.

PROFILE/LOCATIONNUDGECOUNT UInt32

Reserved.

PROFILE/LOCATIONSERVICESTOGGLE Bool

If set to TRUE, the Solstice Location Services setting is turned on to and the app uses location information to try to determine the nearest Pods. If set to FALSE, location services are disabled. (The user must also grant permissions to use location services.)

PROFILE/MANUALMRUDISPLAYS String

Reserved.

PROFILE/MANUALSDSADDRESS String

If your organization has implemented the Solstice Discovery Service (SDS), set this value to the SDS IP address. The Solstice app then uses this Solstice Discovery Service Address setting to show nearby available Solstice displays.

PROFILE/NAME String

Set the value to the user's name as it should appear in a collaboration session. Use quotation marks around the value (such as "First Last").

PROFILE/NOTIFICATIONLEVEL Uint32

Set which notifications you would like the user to receive:
0 – Do not display any notifications.
1 – Display only critical notifications.
2 – Display all notifications.

Notification settings also control notifications for Solstice Conference drivers. Selecting None will turn off performance and compatibility notifications related to using Solstice resources for a video conference.

PROFILE/PINGWARNINGCHECKCOUNT Uint32

Reserved.

PROFILE/PINGWARNINGCHECKINTERVALMS Uint32

Reserved.

PROFILE/PINGWARNINGFAILPERCENTAGE Uint32

Reserved.

PROFILE/PINGWARNINGLATENCYTHRESHOLD Uint32

Reserved.

PROFILE/RELAYSHORTCUT String

Entering a value sets the Conference HotKey shortcut for opening the quick-access Start Conference box to Cmd+Opt+[value]. The default value is 'C', which corresponds to the shortcut Cmd+Opt+C.

PROFILE/RELAYSHOULDSHAREDISPLAY Bool

If set to TRUE, the Share Pod Display setting for Solstice Conference is enabled, allowing a Solstice display to be shared with remote conference participants. If set to FALSE, Share Pod Display is disabled, which may improve performance on some devices.

PROFILE/RELAYWARNINGDURATION Uint32

Reserved.

PROFILE/RELAYWARNINGINTERVALMINS Uint32

Reserved.

PROFILE/SLSDISCONNECTSENSITIVITY

Uint32

Affects how the Solstice Location Service applies auto-disconnect logic to a user's Pod connection. Auto-disconnect sensitivity values range from 0 to 5, where 1 = very low, 5 = very high, and 0 turns off auto-disconnect.

PROFILE/UUID String

Reserved.

Examples of Using Defaults on macOS

Here is an example of how to read the values in the Mersive Solstice app plist:

$ defaults -currentHost read com.mersive.solstice.client

If a settings option is not currently set in the plist, you can create it by specifying the key type and key value. For example, to configure the app to automatically share the desktop with the Solstice display when it connects, you could enter this:

$ defaults -currentHost write com.mersive.solstice.client "PROFILE/AUTOSHAREDESKTOP/TYPE" Bool
$ defaults -currentHost write com.mersive.solstice.client "PROFILE/AUTOSHAREDESKTOP/VALUE" T

Here is an example of how to change a configured setting for the profile name to Jerry:

$ defaults -currentHost write com.mersive.solstice.client "PROFILE/NAME/VALUE" "Jerry"

Here is an example of how to delete a configured setting in the Mersive Solstice app plist:

$ defaults -currentHost delete com.mersive.solstice.client "PROFILE/AUTOSHAREDESKTOP/TYPE"
$ defaults -currentHost delete com.mersive.solstice.client "PROFILE/AUTOSHAREDESKTOP/VALUE"

The Mersive Solstice app reads the plist settings on start-up. If you change plist values using the defaults command while the app is running, the changes will not appear in the Settings section of the application. However, the app will behave in accordance with the new plist setting.

For example, if the plist setting for AUTOSHAREDESKTOP is FALSE when the app is opened, the app will show the Quick Share Desktop setting as OFF. If the AUTOSHAREDESKTOP value is changed to TRUE using the defaults command while the app is running, the Settings page will still show the Quick Share Desktop setting as OFF. However, when the app connects to the display, the desktop will be automatically shared. Exit and restart the Mersive Solstice app to refresh the in-app settings to reflect the updated plist configuration.

Related Topics

Deploy Mersive Solstice App on Windows with MSI

Deploy Mersive Solstice App on Windows with SCCM