Menu Bar App Preferences
A sample configuration profile with the minimum recommended settings for the Patch Menu Bar app is provided below. Use it as a starting point for your own configuration.
Don't forget to deploy a profile that configures Notification Center Alerts or Banners for Patch.
- Enable Notification Center Alerts - Enable persistent notifications (recommended)
- Enable Notification Center Banners - Enable temporary notifications
Domain: com.alectrona.patch-notifier
- Notifications
- Menu Bar Icon
- Appearance
- System Health
- Get Help Button
Settings for notifications and alerts in the Patch Menu Bar app.
| Setting | Description |
|---|---|
| EnableMenuBarApp | Set to |
| EnableAvailableUpdateAlertDelivery | Set to Deprecated in 3.8 This key has been replaced by info If not managed, users can modify this in the Patch Menu Bar app's settings. |
| NotificationDeliveryType | Controls how the Patch Menu Bar app delivers update notifications. Valid values are Replaces EnableAvailableUpdateAlertDelivery Existing configurations that set info If not managed, users can modify this in the Patch Menu Bar app's settings. |
| NotificationAutoDismissDuration | The number of seconds a popover or banner notification remains on screen before dismissing automatically. The default is 5 seconds. Has no effect when info If not managed, users can modify this in the Patch Menu Bar app's settings. |
| AvailableUpdateAlertSoundPolicy | Set to an integer to force a specific notification sound policy for available update notifications. 0 for no sound, 1 to play a sound. The default value is 0. info If not managed, users can modify this in the Patch Menu Bar app's settings. |
| NextActionDelaySeconds | Indicates the number of seconds after the delivery of an available update notification to wait to either defer the update or auto-update the app if the deferral limit has been reached. The default value is 600 seconds (10 minutes). info If not managed, users can modify this in the Patch Menu Bar app's settings. |
| ShowAlertBeforeAutoUpdate | When a deferral limit is reached for an app, an auto-update of the app will occur. Before that happens an auto-update alert will be displayed which can break through Do Not Disturb settings. warning Setting this to info If not managed, users can modify this in the Patch Menu Bar app's settings. |
| AutoUpdateAlertDisplayDuration | This value indicates the display duration for the auto-update alert in seconds. The default value is 60 seconds. info If not managed, users can modify this in the Patch Menu Bar app's settings. |
| BringToFrontOnAutoUpdateAlert | Controls whether the Patch Menu Bar app activates itself (taking focus) when the auto-update alert popover appears. Defaults to info If not managed, users can modify this in the Patch Menu Bar app's settings. |
| DeferImmediatelyWhenBelowLimit | When set to info If not managed, users can modify this in the Patch Menu Bar app's settings. |
| BackgroundInstallAlertDeliveryPolicy | Set to an integer to force a specific notification delivery policy for background installations/updates. 0 for none, 1 for individual, 2 for digest. The default value is 0. info If not managed, users can modify this in the Patch Menu Bar app's settings. |
| BackgroundInstallAlertSoundPolicy | Set to an integer to force a specific notification sound policy for background installations/updates. 0 for no sound, 1 to play a sound. The default value is 0. info If not managed, users can modify this in the Patch Menu Bar app's settings. |
| HidePatchInBackgroundInstallAlerts | Set to |
Settings for the Patch Menu Bar App's displayed icon.
| Setting | Description |
|---|---|
| MenuBarIcon | Set to the path/url of a custom image to display in the Menu Bar which replaces the Patch app's default Menu Bar icon. Remote Image Support It is recommended to use a local file path for this image. However, you can also specify a remote URL, which will be downloaded and cached for optimal performance. |
| MenuBarIconRenderAsTemplate | Set this value to tip For best results with template mode, use simple images with transparent backgrounds. Avoid detailed graphics or full-color images, as they may not render clearly when tinted. |
| MenuBarIconSymbolName | Set the Menu Bar App's icon to an SF Symbol by name. |
| MenuBarIconBlinkBadge | Set this value to true to force the Patch Menu Bar app's red badge to blink when there are updates available. info If not managed, users can modify this in the Patch Menu Bar app's settings. |
Settings to customize the appearance of the Patch Menu Bar app.
| Setting | Description |
|---|---|
| NotificationCenterIcon | Set to the path of a custom icon to use for Patch app alerts in Notification Center. note This does not guarantee Notification Center will reflect the new icon immediately due to OS-level caching. info It is recommended to use a square image to avoid stretching. Remote Image Support It is recommended to use a local file path for this image. However, you can also specify a remote URL, which will be downloaded and cached for optimal performance. tip You can also manually set the Patch app's icon with our
|
| TopBrandingImage | Set to the path/url of a custom image to display in the upper left corner of the app when in light mode or if a dark mode icon is not set. Remote Image Support It is recommended to use a local file path for this image. However, you can also specify a remote URL, which will be downloaded and cached for optimal performance. |
| TopBrandingImageDark | Set to the path/url of a custom image to display in the upper left corner of the app when in dark mode. Remote Image Support It is recommended to use a local file path for this image. However, you can also specify a remote URL, which will be downloaded and cached for optimal performance. |
| TopBrandingImageHeight | Set to an integer to override the height point value of the top custom image. The default value is 30 points. |
| HideTopBrandingImage | Set to |
| TopBrandingTitle | The title text to the right of the top branding image. |
| TopBrandingTitleFont | Set to the name of a font face that the top branding title should be displayed in. info The default value is "SF Pro Text". This font is available on all macOS devices. If you set this to a font that is not available on the user's device, the system will use the default font instead. |
| TopBrandingTitleFontHeight | Set to an integer to override the height point value of the top branding title. The default value is 22 points. |
| HideTopBrandingTitle | Set to |
| TopBrandingSubtitle | This value can be configured to display a custom subtitle under the top branding title. |
| TopBrandingSubtitleFont | Set to the name of a font face that the top branding subtitle should be displayed in. info The default value is "SF Pro Text". This font is available on all macOS devices. If you set this to a font that is not available on the user's device, the system will use the default font instead. |
| TopBrandingSubtitleFontHeight | Set to an integer to override the height point value of the top branding subtitle. The default value is 10 points. |
| TopBrandingHeadingText | Set to a string to override the default "Software Updates" heading. |
| HideTopBrandingHeading | Set to |
| ShowIgnoredUpdateAlertBadges | Set to info If not managed, users can modify this in the Patch Menu Bar app's settings. |
| HidePatchInHistory | Set value to |
| HideSettingsMenu | Set value to info Hiding the Settings menu prevents users from accessing settings and preferences directly from the Patch Menu Bar app, and also removes their ability to check for updates manually. |
Settings for the "System" tab in the Patch Menu Bar app, which provides quick access to system information and warnings.
| Setting | Description |
|---|---|
| ShowMacOSUpdates | Set this value to macOS Update Availability Available macOS updates are based on what the system reports in System Settings—this reflects either managed update settings or what Apple currently offers to the device. This may not always be the latest macOS version released. Only macOS updates are shown; security and other system updates are not included. info If not managed, users can modify this in the Patch Menu Bar app's settings. |
| ShowUptimeWarnings | Set this value to info If not managed, users can modify this in the Patch Menu Bar app's settings. |
| UptimeDayThreshold | Set this to an integer to define the number of days of uptime after which a warning will be displayed in the "System" tab. The default is 7 days. info If not managed, users can modify this in the Patch Menu Bar app's settings. |
| ShowStorageUsageWarnings | Set this value to info If not managed, users can modify this in the Patch Menu Bar app's settings. |
| StorageUsageThreshold | Set this to an integer percentage at which a warning will be displayed in the "System" tab. The default is 90 percent. info If not managed, users can modify this in the Patch Menu Bar app's settings. |
Settings for the Get Help button in the Patch Menu Bar app.
| Setting | Description |
|---|---|
| GetHelpEnabled | Set to |
| GetHelpTitle | Set to a string to override the default title of the Get Help view. |
| GetHelpDescription | Set to a string to override the default description of the Get Help view. |
| GetHelpButtonLabel | Set to a string to override the default |
| GetHelpButtonIconGlyphColor | Set to a hex color to override the default color of the glyph in the symbol of the Get Help Button. |
| GetHelpButtonIconGlyphColorDark | Set to a hex color to override the default color of the glyph in the symbol of the Get Help Button (when in dark mode). |
| GetHelpButtonIconContainerColor | Set to a hex color to override the default color of the symbol's container in the Get Help Button. |
| GetHelpButtonIconContainerColorDark | Set to a hex color to override the default color of the symbol's container in the Get Help Button (when in dark mode). |
| GetHelpActionButtons | An array of dictionaries representing the buttons in the Get Help view. Each dictionary should contain the keys Action Types The Dismiss Behavior The optional Prominent Buttons You can use the |