Target Displays

With more than one display connected, a brightness key needs a destination. These preferences let you follow the pointer, follow the window you are working in, or adjust all suitable screens together. Audio has its own target choice, so you can change the screen in front of you while keeping volume keys associated with the current sound output.

These are saved destination preferences. The native-key switches separately decide whether BetterDisplay handles the keyboard's brightness and audio keys in the first place.

Where to find it: Settings > Keyboard, under Brightness Keys, Video Adjustment Shortcuts Affect: and Volume Control Affects:.

Brightness and audio keyboard target choices

Brightness follows the pointer, while volume matches the current audio device. All-screen targeting bypasses the corresponding group synchronization.

Brightness and video adjustments

Choose the rule that best matches how you move between your displays:

Existing saved choices are preserved. When upgrading from an older release, BetterDisplay also keeps the previous pointer-based default if an external physical display was detected within the last 15 days, even if it is now disconnected. Virtual displays do not count for this check. You can choose either behavior here at any time.

Ordinary targeting respects Keyboard control affects this display in that display's General Settings. If no screen or suitable control is found, the video operation does nothing. It does not choose an unrelated display.

Mirrors and streamed displays

A chosen screen may also supply an image to other screens through mirroring or full-screen streaming. In pointer or focus mode, Adjustments affect mirror and stream targets appears below the video target choices and is enabled by default. It includes the chosen display's mirror and active stream targets because the intended display is ambiguous. Disable it to target only the source display.

Group synchronization remains independent and may propagate changes to targets. Source-side overlay adjustments may also remain visible in the mirrored or streamed image.

Brightness control takes these relationships into account. BetterDisplay chooses suitable hardware, software or combined controls, avoiding an ineffective overlay on a mirror/stream target and avoiding a second adjustment to the source when a target was already adjusted. External HDR mode and the display's brightness-controller preferences can change which brightness component is available.

Audio controls

Volume usually belongs with the sound output, which may be on a different display from the pointer. The default, Display with the same name as current audio device, associates volume keys with that output by matching its name to a display's product name. The comparison normalizes the names and ignores letter case.

You can use a display's audio-device override when names alone are not enough. An override can match part of the device name or its unique identifier. More than one display can match, and all matching displays can receive the operation. Use each display’s audio settings to distinguish similarly named devices when needed.

If you would rather choose audio targets spatially, select Screen with the window or desktop in focus (active screen), Screen with the mouse pointer, or All suitable screens. Pointer and focus choices include mirror and active stream targets independently of the video target switch. Keyboard-disabled displays are filtered out, and volume and mute each require their corresponding controls.

When the current audio device is used instead

With Handle devices with native volume control enabled, BetterDisplay can fall back to the current macOS audio device when no selected display handles the adjustment. The current output must support the corresponding native volume or mute control.

A successful display operation prevents native fallback. This includes issuing a volume-up/down or mute-toggle command, even when the display cannot report its level or mute state. A hardware write that later fails does not trigger a second adjustment through macOS.

Group synchronization and scope

A display group can normally carry an adjustment from one display to others. All suitable screens already selects the displays directly, so keyboard brightness changes bypass group brightness synchronization in this mode. Keyboard volume and mute changes likewise bypass their group synchronization. This prevents the same adjustment from arriving twice. The group’s saved synchronization settings still apply to other operations.

These radio groups govern brightness, video-adjustment and audio targeting, but some shortcuts deliberately choose their own destination. Mode, rotation, power and several display-management shortcuts use the pointer screen. Input-source slots can name a display explicitly, while streaming shortcuts have their own selection rules. See Custom Keyboard Shortcuts for those actions.

For per-display audio association, mute methods and the volume-overlay preference, see Audio Device Configuration.

Additional information

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

Features requiring Pro license

Choosing keyboard target displays does not require Pro. The selected adjustment still follows its own license requirements. Basic Brightness synchronization in the default group remains available without Pro.

Platform compatibility

All features described on this page are available on both Apple silicon and Intel Macs. A chosen display or audio device must provide the control needed for that operation.