-
Notifications
You must be signed in to change notification settings - Fork 104
Display Behavior
The dialogs and notifications displayed by super may be ignored by the user, thus preventing the workflow from continuing. To help cope with users who ignore super messaging you can adjust several options that affect the behavior of these dialogs and notifications.
Note that options differ between interactive dialogs (that appear in the middle of the screen and are expecting a response from the user) and temporary notifications (that normally appear in the top right and dissmiss automatically). Detailed documentation regarding customizing other display interface options (like using a custom display icon) can be found here, and customizing the display language can be found here.
Disable the user's ability to move super dialogs and notifications.
Command option example:
--display-unmovable=ALWAYS,DIALOG,DEADLINE,SCHEDULED,INSTALLNOW,ERROR
Command option disable example:
--display-unmovable=X
Configuration profile example:
<key>DisplayUnmovable</key>
<string>ALWAYS,DIALOG,DEADLINE,SCHEDULED,INSTALLNOW,ERROR</string>
Using this option disables the default behavior of allowing the user to move (by clicking and dragging from the titlebar) super dialogs and notifications.
You can use any combination of the following display unmovable types:
-
Disable the user's ability to move any dialog or notification:
--display-unmovable=ALWAYS -
Disable the user's ability to move interactive dialogs (like the user authentication dialog):
--display-unmovable=DIALOG -
Disable the user's ability to move dialogs or notifications if any deadline has passed:
--display-unmovable=DEADLINE -
Disable the user's ability to move dialogs or notifications if a scheduled install workflow is active:
--display-unmovable=SCHEDULED -
Disable the user's ability to move dialogs or notifications if a install now workflow is active:
--display-unmovable=INSTALLNOW -
Disable the user's ability to move dialogs or notifications if there is a workflow error:
--display-unmovable=ERROR
Hide the background while displaying super dialogs and notifications.
Command option example:
--display-hide-background=ALWAYS,DIALOG,DEADLINE,SCHEDULED,INSTALLNOW,ERROR
Command option disable example:
--display-hide-background=X
Configuration profile example:
<key>DisplayHideBackground</key>
<string>ALWAYS,DIALOG,DEADLINE,SCHEDULED,INSTALLNOW,ERROR</string>
Using this option hides all other windows (including full screen mode) and the background via blur effect while displaying super dialogs and notifications.
Note that it's not possible to hide the background while displaying the insufficient storage dialog. This is because it would prevent user from being able to access the built-in macOS Storage Settings (or Storage Manager on older macOS systems) to assist the user in removing unnecessary items.
You can use any combination of the following display hide background types:
-
Hide the background while displaying any dialog or notification:
--display-hide-background=ALWAYS -
Hide the background while displaying interactive dialogs (like the user authentication dialog):
--display-hide-background=DIALOG -
Hide the background while displaying dialogs or notifications if any deadline has passed:
--display-hide-background=DEADLINE -
Hide the background while displaying dialogs or notifications if a scheduled install workflow is active:
--display-hide-background=SCHEDULED -
Hide the background while displaying dialogs or notifications if a install now workflow is active:
--display-hide-background=INSTALLNOW -
Hide the background while displaying dialogs or notifications if there is a workflow error:
--display-hide-background=ERROR
Do not play the system alert sound when opening super dialogs and notifications.
Command option example:
--display-silently=ALWAYS,DIALOG,DEADLINE,SCHEDULED,INSTALLNOW,ERROR
Command option disable example:
--display-silently=X
Configuration profile example:
<key>DisplaySilently</key>
<string>ALWAYS,DIALOG,DEADLINE,SCHEDULED,INSTALLNOW,ERROR</string>
Using this option disables the default behavior of playing the system alert sound for super dialogs and notifications.
You can use any combination of the following display silently types:
-
Do not play the system alert sound when opening any dialog or notification:
--display-silently=ALWAYS -
Do not play the system alert sound when opening interactive dialogs (like the user authentication dialog):
--display-silently=DIALOG -
Do not play the system alert sound when opening dialogs or notifications if any deadline has passed:
--display-silently=DEADLINE -
Do not play the system alert sound when opening dialogs or notifications if a scheduled install workflow is active:
--display-silentle=SCHEDULED -
Do not play the system alert sound when opening dialogs or notifications if a install now workflow is active:
--display-silently=INSTALLNOW -
Do not play the system alert sound when opening dialogs or notifications if there is a workflow error:
--display-silently=ERROR
Display super notifications without showing a progress bar.
Command option example:
--display-hide-progress-bar=ALWAYS,DEADLINE,SCHEDULED,INSTALLNOW,ERROR
Command option disable example:
--display-hide-progress-bar=X
Configuration profile example:
<key>DisplayHideProgressBar</key>
<string>ALWAYS,DEADLINE,SCHEDULED,INSTALLNOW,ERROR</string>
Using this option overrides the default behavior of super notifications displaying a progress bar.
You can use any combination of the following display silently types:
-
Hide the progress bar for all notifications:
--display-notifications-centered=ALWAYS -
Hide the progress bar for notifications if any deadline has passed:
--display-notifications-centered=DEADLINE -
Hide the progress bar for notifications if a scheduled install workflow is active:
--display-notifications-centered=SCHEDULED -
Hide the progress bar for notifications if a install now workflow is active:
--display-notifications-centered=INSTALLNOW -
Hide the progress bar for notifications if there is a workflow error:
--display-notifications-centered=ERROR
Display super notifications in the center of the screen.
Command option example:
--display-notifications-centered=ALWAYS,DEADLINE,SCHEDULED,INSTALLNOW,ERROR
Command option disable example:
--display-notifications-centered=X
Configuration profile example:
<key>DisplayNotificationsCentered</key>
<string>ALWAYS,DEADLINE,SCHEDULED,INSTALLNOW,ERROR</string>
Using this option overrides the default behavior of super notifications displaying in the top-right corner of the screen.
You can use any combination of the following display silently types:
-
Display all notifications in the center of the screen:
--display-notifications-centered=ALWAYS -
Display notifications in the center of the screen if any deadline has passed:
--display-notifications-centered=DEADLINE -
Display notifications in the center of the screen if a scheduled install workflow is active:
--display-notifications-centered=SCHEDULED -
Display notifications in the center of the screen if a install now workflow is active:
--display-notifications-centered=INSTALLNOW -
Display notifications in the center of the screen if there is a workflow error:
--display-notifications-centered=ERROR