Mersive Solstice App Defaults on macOS
CFPreferences (core foundation preferences) for the Mersive Solstice app on a Mac laptop 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.
Note
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 when they connect to a Solstice display and/or (starting in Solstice 5.5.2) connect to room devices for Solstice-enabled video conferencing. |
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 show 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 show 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/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 want the user to receive: 0 – Do not display any notifications. 1 – Display only critical notifications. 2 – Display all notifications. Note Notification settings also control notifications for Solstice Conference drivers. Selecting None turns 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. |
(Deprecated in Solstice 5.5.2) PROFILE/RELAYSHORTCUT | String | For Mersive Solstice app versions 5.5.1 and earlier, entering a value sets the Conference HotKey shortcut for quickly starting a Solstice-enabled video conference 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 is enabled, allowing a Solstice display to be shared with a video conference. If set to FALSE (default), Share Pod Display is disabled, which may improve performance on some devices. |
PROFILE/RELAYWARNINGDURATION | Uint32 | Reserved. |
PROFILE/RELAYWARNINGINTERVALMINS | Uint32 | Reserved. |
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"
Note
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.
Note
For example, if the plist setting for AUTOSHAREDESKTOP is FALSE when the app is opened, the app shows 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.