Skip to main content

Classic Update Dialog Preferences

These preferences configure the various options for the Classic Update Dialog style of notifications.

Domain: com.alectrona.patch-notifier

SettingDescription
DialogDescription

The main description that appears in the notification.

<key>DialogDescription</key>
<string>Awesome description.</string>
UpdateButtonLabel

The label or displayed text in the update button.

<key>UpdateButtonLabel</key>
<string>Update</string>
DeferButtonLabel

The label or displayed text in the defer button.

<key>DeferButtonLabel</key>
<string>Later</string>
UpdateButtonPrimary

By default, the Update button is the primary button of the notification; meaning it responds to the Return key. Set this key to false if you wish to disable this behavior.

<key>UpdateButtonPrimary</key>
<false/>
ContentImagePath

Either a path to a locally stored image OR a web URL of an image (PNG/JPG/GIF/TIFF) to display as a small overlay in the lower right corner of the notification's app icon.

<key>ContentImagePath</key>
<string>https://example.com/file.png</string>
DialogTimeout

The duration, in seconds, that the notification will appear on screen before performing a timeout.

<key>DialogTimeout</key>
<integer>120</integer>
DialogHelpText

Enable the help button and populate the text displayed on screen when clicked.

<key>DialogHelpText</key>
<string>Not to worry, your company is here to help.</string>
DialogHelpToolTip

Customizes the tooltip of the help button (when enabled).

<key>DialogHelpToolTip</key>
<string>About this message.</string>
DialogIsMovable

Set to false to disable movement of the notification.

<key>DialogIsMovable</key>
<false/>
DialogPosition

The position on-screen that the notification will appear. Valid values are topleft, top, topright, left, center, right, bottomleft, bottom, bottomright.

<key>DialogPosition</key>
<string>topright</string>
DisplayOnActiveScreen

Set to true to display notifications on the active screen (the screen where the frontmost activated app is located).

<key>DisplayOnActiveScreen</key>
<true/>
DialogCanDeactivate

Set to true to allow notifications from Alectrona Patch to be hidden behind other windows.

warning

Enabling this setting may result in missed notifications, potentially leading to non-compliant devices.

<key>DialogCanDeactivate</key>
<false/>
DialogTransparencyLevel

The transparency level of the notification. Valid values range from 0-2 (default is 1).

<key>DialogTransparencyLevel</key>
<integer>2</integer>
RecordTimeoutAsDeferral

Set to true to count automatic deferrals due to notification timeouts towards Deferral Limits.

<key>RecordTimeoutAsDeferral</key>
<true/>
RecordDeferralDuringDND

Set to true to count automatic deferrals due to Do Not Disturb towards Deferral Limits.

info

This key is only applicable if either the RespectDND key for Patch Agent is set to true or if using the --respect-dnd flag.

<key>RecordDeferralDuringDND</key>
<true/>
RecordDeferralDuringMeetings

Set to true to count automatic deferrals due to video meetings towards Deferral Limits.

info

This key is only applicable if either the RespectMeetings key for Patch Agent is set to true or if using the --respect-meetings flag.

<key>RecordDeferralDuringMeetings</key>
<true/>
CustomMeetingAppBundleIdentifiers

Specify a list of application bundle identifiers that Alectrona Patch will respect as a meeting app.

info

This key is only applicable if either the RespectMeetings key for Patch Agent is set to true or if using the --respect-meetings flag.

<key>CustomMeetingAppBundleIdentifiers</key>
<array>
  <string>com.hnc.Discord</string>
  <string>com.vsee.VSee</string>
</array>
Last updated on