Displays

Set the brightness of every display, external monitors included, and switch Night Shift, resolutions, mirroring and display arrangements from the bar.

Most of it lives on Settings → Displays & Brightness, and the everyday parts are commands you can type or put on a hotkey.

Brightness

Settings → Displays & Brightness has a slider for each display in the Brightness card. Select one and press ← or → to change it by 5 %. The line under each slider says how Saiki controls that display:

SaysWhich displays
The system's brightnessThe built-in display and Apple displays.
Over DDC/CIExternal monitors that accept brightness over the cable, using the monitor's own control.
Dimmed in softwareMonitors with no DDC on that connection: the picture is dimmed instead.

For a monitor that offers the choice, two more switches appear:

From the bar

Extra Brightness

On a MacBook Pro with a built-in XDR display (14″ or 16″), Extra Brightness pushes the screen past its usual maximum by using the panel's HDR headroom for everything on screen. Turn it on with Toggle Extra Brightness in the bar or the Extra Brightness row in Settings. While it's on, Extra Brightness level sets how much of the headroom it takes, from 10 % to 100 % (← / →). macOS stays in charge of the panel: if the Mac gets hot or low on power, the headroom shrinks and Extra Brightness follows.

On other Macs the row says "Not Available" and the command doesn't show.

Night Shift

Toggle Night Shift switches to warmer colours and back, the same as System Settings → Displays → Night Shift. The row shows whether it's on now. It's also the Night Shift row in the Colour card in Settings.

Resolution

Type resolution to list each display's modes worded as System Settings does, such as "Looks like 1512 × 982 · 120 Hz", with the one in use marked Current. Settings has the same list in a card per display, where macOS's own choice is marked Default and the line under a mode says how many pixels it's drawn at. Press ↵ on a mode and a card asks first, because the screen blanks for a moment while it changes. Press ⌘↵ to change it.

Mirroring

With a second display connected, Toggle Display Mirroring makes every external display show what the Mac's does, or goes back to each showing its own desktop. It asks on a card first. Mirroring lasts until you turn it off or log out. In Settings it's the Mirror Displays row in the Arrangement card, which says Mirroring or Extended.

Arrangements

Save where your displays sit and put them back later, for example one arrangement for your desk and one for a projector.

  1. Arrange your displays the way you want in System Settings.
  2. On Settings → Displays & Brightness, choose Save Current Arrangement… in the Arrangement card and give it a name.
  3. Later, type arrangement and press ↵ on Arrange Displays: name, or ↵ on the preset in Settings. A card asks first. Displays the preset doesn't know stay where they are.

To delete a preset, select it in Settings and press ⌘⌫ (Delete Preset), or press ⌃X (Delete Preset in ⌘K) on its row in the bar. Saving needs at least two displays.

Settings

The switch at the top of Settings → Displays & Brightness turns all of this off. The brightness service starts only when something needs it: the Settings page, a brightness search or a brightness command.

Mirroring and arrangements need a second display. With one display, their rows say so and the commands don't show.