Display Behavior

The interactive dialogs (that appear in the middle of the screen and are expecting a response from the user) and notifications (that normally appear in the top right and dismiss automatically) 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.

Detailed documentation regarding customizing other display interface options (like using a custom display icon) can befound here(https://github.com/Macjutsu/super/wiki/Display-Customization), and customizing the display language can befound here(https://github.com/Macjutsu/super/wiki/Display-Language).

Display Option Types

The display behavior options documented on this page allow you to choose from the following six types. Importantly, more than one type may be specified as long as they are separated by commas with no spaces:

• The display behavior option should be used for every workflow (this encompasses all of the other types): ALWAYS

• The display behavior option should be used for interactive dialogs: DIALOG

• The display behavior option should be used if the workflow has passed a deadline: DEADLINE

• The display behavior option should be used for scheduled install workflows: SCHEDULED

• The display behavior option should be used for install now workflows: INSTALLNOW

• The display behavior option should be used if there is a workflow error: ERROR

Display Unmovable Dialogs and Notifications

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 title bar) super dialogs and notifications.

Display Hide Background

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 a 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.

Display Dialogs and Notifications Silently

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.

Hide Notification Progress Bars

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.

Note that because this display behavior option is unique to notifications, it does not allow for the display behavior type of DIALOG.

Display Notifications Centered

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.

Note that because this display behavior option is unique to notifications, it does not allow for the display behavior type of DIALOG.