Menu Bar Icon

The menu-bar icon is the usual entry point to BetterDisplay’s App Menu. These settings let you choose its image and alignment, or hide it when you prefer to reach the app another way. The icon can also indicate a paused stream, an available update or that BetterDisplay is preventing display sleep.

Where to find it: Settings > Menu > Menu Bar Icon. Enable Show app icon in the menu bar to reveal Menu Bar Icon Options….

Menu Bar Icon Options with appearance and alignment options

Menu Bar Icon Options with appearance and alignment options.

Visibility and returning to Settings

Show app icon in the menu bar is on by default. Turning it off hides the icon while leaving BetterDisplay running.

If you hide it, reopen BetterDisplay normally from Finder or the Dock to return to Settings, then enable the switch again. The App Menu button in Settings also gives you access to the menu there. Safe Mode forces the icon to remain visible.

When a display also asks to hide the icon

A display’s additional settings can request that the icon be hidden. The notice below the visibility switch means a remembered display has this rule. The icon may still be visible because other connected displays do not request it.

The display-based rule hides the icon only when every display currently present requests it and at least one such display is present. For example, one display requesting a hidden icon does not necessarily hide it while another display remains present. Remembered absent displays can make the notice appear, but they do not count toward the all-displays check.

The sheet scrolls and can be resized. It starts with custom app icons and rendering, followed by a separate alignment box, Display and Group Icons, and Status Icons. Scroll to reach the lower options. Done stays available at the bottom, and the sheet remembers its size.

Choose a custom symbol

Custom SF Symbol app icon accepts an SF Symbols name, such as face.smiling. Select Browse… to open the shared symbol picker, search for a symbol and choose it. The selection takes effect immediately. Done closes the picker. Remove clears the custom choice.

The symbols available in the picker depend on macOS. If you type an unrecognized name, the icon falls back to a dashed rectangle. Clear the field to allow display or group matching, if enabled, or the usual BetterDisplay icon.

Custom SF Symbol for dark appearance lets you choose a different symbol when the menu bar has a dark appearance. For example, use macpro.gen1 as the regular symbol and macpro.gen1.fill for dark appearance. Its Browse… button opens the same symbol picker. Leave the dark field empty to use the regular icon in both appearances. You can also leave the regular field empty to allow display or group matching, or the usual BetterDisplay icon, in light appearance.

The choice follows the menu bar’s appearance, which can differ from the system appearance depending on the wallpaper. It updates automatically when that appearance changes. An unrecognized dark symbol also shows the dashed rectangle. Both choices are saved independently.

Scripts can set or read these choices with appMenuIcon and appMenuIconDark. See Custom menu bar icons for commands that configure or clear either choice.

Hierarchical rendering for SF Symbol menu icons is on by default and uses different shades for a symbol’s layers. Turn it off to render the symbol in a single shade. The change takes effect immediately and applies to both custom symbol fields, display and linked virtual-screen symbols used through main-display matching, custom group symbols, and the alternate paused-stream and sleep-prevention symbols.

Align the attached menu

Centered menu bar icon centers the icon relative to the attached menu. With it off, the menu uses the traditional leading-side alignment. The option is off by default and unavailable while Sidebar presentation is active.

Display and Group Icons

Match menu icon with main display icon is off by default. Enable it to use the current main display’s displayed icon, including its linked virtual screen’s icon where applicable. This gives the menu-bar icon a connection to the display currently serving as your main screen.

Match menu icon with current sole display group's custom icon is off by default. Enable it to use the group’s custom icon when exactly one group is active. Configure the icon under the group’s Advanced… settings.

This option is unavailable while main-display matching is enabled. Its saved choice is retained and becomes available again when you turn main-display matching off. A nonempty custom app symbol still takes precedence over either matching option.

All active groups count, including Default Group. If no groups or multiple groups are active, or the sole active group has no valid custom icon, group matching has no effect. The group’s ordinary default icon is never substituted. A custom icon configured for Default Group is eligible when that group is the only active one.

The menu-bar icon updates as group activation or custom icons change. See group activation rules if the expected group is inactive or more than one group is active.

Status icons and priority

A status indication can temporarily take the place of your chosen image. BetterDisplay uses this priority order:

  1. The alternate paused-stream icon, when enabled and at least one active stream is paused.
  2. The alternate sleep-prevention icon, when enabled and the app is actively preventing display sleep.
  3. The update-available app icon.
  4. Your nonempty custom symbol, using the dark override when applicable and the regular symbol otherwise.
  5. The main display’s icon, including its linked virtual screen’s icon, when matching is enabled.
  6. The sole active group’s valid custom icon, when group matching is enabled and main-display matching is off.
  7. The usual BetterDisplay icon.

The sleep-prevention option is labeled Use … as menu icon when the app is preventing display sleep, with a cup icon in its label. It is off by default. Enable it to show when sleep prevention is active. A filled cup indicates global Prevent Sleep. An outlined cup indicates that only a connected display’s Prevent Sleep While Connected preference is keeping the Mac awake. To turn sleep prevention on, use either of those separate settings.

Use … as menu icon when a stream is paused, with a pause symbol in its label, is also off by default. Enable it to monitor paused Picture in Picture, screen streams and selected-content streams without opening the App Menu. For example, it can help you track a paused stream while sharing its window in a meeting.

The pause icon stays visible while any active stream is paused, even if other streams are running. When the last paused stream resumes or stops, the icon returns to the next applicable image in the priority order. Each paused stream’s own App Menu item also shows a pause symbol, whether or not this menu-bar option is enabled.

All of these icon preferences are saved without a separate Apply step. See Menu Appearance & Behavior for Standard and Sidebar presentation.

Additional information

This section explains which features require Pro and how availability differs between Mac platforms.

Features requiring Pro license

No Pro license is required for the icon visibility, symbol, status-indication or alignment preferences on this page. Using custom groups still requires Pro, while Default Group is available without Pro. See group feature availability. Changing an icon does not enable the underlying display or sleep-control feature it represents.

Platform compatibility

All features described on this page are available on both Apple silicon and Intel Macs. The symbol library depends on the installed macOS version. Centered alignment applies to the attached Standard presentation and is unavailable while Sidebar is active.