Help

Mercurio: Display Plus

A menu bar app for every display on your Mac: brightness, resolution, color, picture in picture and virtual screens. This page is for the version from our website; for the Mac App Store version see Display Plus from the Mac App Store.

What you need

  • A Mac with Apple silicon (M1 or later) and macOS 14 Sonoma or later.
  • For brightness, volume and input of an external monitor over the cable: a monitor with DDC/CI. Some docks, adapters and TVs do not pass these commands on; then Display Plus dims in software.

Get started

  1. Move Display Plus.app to your Applications folder and open it. A symbol appears in the menu bar; the app has no window and no Dock icon unless you switch it on under Settings › General.
  2. Click the symbol and paste your license key (see License).
  3. Every display now has its card. Move the sliders, or click More for all settings of a display.
  4. Settings at the bottom of the menu opens the settings window, also with ⌘, while the menu is open.

First start

The version from our website is signed with our Apple Developer ID and notarized by Apple. On the first start macOS asks once whether you want to open an app downloaded from the internet; click Open.

License

  • Your license key (MD-XXXX-XXXX-XXXX-XXXX) is on your download page. Paste it into the Display Plus menu and click Activate. Activation needs internet once; after that the app works offline.
  • One key works on one Mac at a time. To move it, click Deactivate this Mac under Settings › License on the old Mac, then activate the key on the new Mac. After deactivating, Display Plus puts every display back to normal and the display controls stop on that Mac.
  • The menu says the key is already active on another Mac? Deactivate it there first. Old Mac broken or sold without deactivating? Write to hello@mercuriolabs.app with your key, and we free it.
  • When activating, the app sends the key and an anonymous ID of your Mac (a one-way hash, not the serial number) to mercuriolabs.app. Nothing else leaves your Mac.

Permissions

Display Plus asks for a permission only when you switch on a function that needs it.

  • Accessibility: lets Display Plus listen to the brightness and volume keys of your keyboard, so they work on every display, not only the built-in one. Without it, the keys keep their normal macOS behavior. Change it under System Settings › Privacy & Security › Accessibility.
  • Screen Recording: picture in picture, streams and the filter window show the picture of a display or window, and macOS allows that only with this permission. The picture is shown on your Mac only; nothing is recorded, stored or sent. Change it under System Settings › Privacy & Security › Screen & System Audio Recording.
  • Automation (System Events): the Dark mode tool asks macOS to switch between light and dark appearance. macOS asks once whether Display Plus may control System Events.

Website and App Store version

Apple does not allow some functions in Mac App Store apps, so the two versions differ. Functions a version does not have do not appear in it at all.

FunctionWebsiteMac App Store
Brightness by software dimming, resolution, HiDPI on displays macOS offers it forYesYes
Main display, mirroring, arrangement, protect settingsYesYes
Color profiles, invert, picture settings, rounded cornersYesYes
Picture in picture, streams, filter window, LUT filtersYesYes
Groups, stay awake, shortcuts, links, command lineYesYes
Local web server for scriptsYesNo
macOS brightness of the built-in display, extra brightness on XDR displays, follow ambient lightYesNo
Dark mode, Night Shift and True Tone switchesYesNo
Brightness, volume, contrast and input over the cable (DDC/CI)YesNo
Brightness and volume keys for every displayYesNo
Virtual screens, HiDPI on any monitor, flexible scaling and own resolutionsYesNo
Disconnect and connect, rotation, EDID, color modeYesNo
Saturation, vibrance, hue, sepia and grayscale per displayYesNo
How you get itOne-time purchase here, license per Mac14 days free, then a one-time in-app purchase

The menu

  • One card per display: name, size, refresh rate and chips like HiDPI or Main, a brightness slider and a resolution slider. Left on the resolution slider means larger text, right means more space. The tiles below switch what this display can do.
  • More opens four tabs: Display, Color, Picture and Stream. Opening one display closes the others; you can change this under Settings › General.
  • The symbol in the top corner of each card shows a large label on that display, so you know which one is which.

Brightness

  • The built-in display and Apple displays use macOS brightness. External monitors change their own brightness over the cable (DDC/CI), and volume, contrast, input and standby where the monitor supports it.
  • Where a display cannot change its own brightness, Display Plus dims the picture in software. Dim below the minimum on the display's settings page makes the lowest part of the slider darker still.
  • On XDR displays, Extra brightness (XDR) in the Color tab lets the slider go past 100 %; the extra range shows in a warm color.
  • Follow ambient light lets an external display follow the built-in one.

Resolution and arrangement

  • The Display tab lists every resolution. Click the star to keep one as a favorite; Show all modes adds low resolution and other refresh rates.
  • HiDPI shows text sharp at half the size in points. Display Plus also offers HiDPI on monitors where macOS does not, through a hidden helper screen; Flexible scaling and Own resolutions on the display's settings page work the same way while the app is open.
  • Main display moves the menu bar and Dock to this display. Mirror shows another display's picture. Rotate turns the picture by 90° steps, Disconnect switches a display off without pulling the cable, and Connect all brings them all back.
  • Protect settings remembers resolution, color profile, mirroring and main display and puts them back when macOS or another app changes them.

Color and picture

  • Color holds the color profile, invert colors and grayscale, plus color mode, HDR and the information the display reports about itself (EDID) on its settings page.
  • Picture sets contrast, gamma, gain, highlights, shadows, color temperature, saturation, vibrance, hue and sepia, and Channels and levels for red, green and blue. Rounded corners rounds the top and bottom of the screen. Reset puts everything back.

Picture in picture and streams

  • PiP shows a display in a floating window. You can set the window level, opacity, zoom, frame rate, the pointer, click through, locked position and more under Settings › Picture in picture.
  • Stream to a display shows a display full screen on another one. Stream window in the tools shows a single window in picture in picture.
  • Filter window is a frame you place over anything; it shows what lies under it with your filters. You can import color lookup tables (3D LUTs as .cube files) under Settings › LUT filters.

Virtual screens

  • A virtual screen exists only on your Mac. Show it in picture in picture, stream or mirror it, or share and record it in other apps.
  • Create one with New in the menu or under Settings › Virtual screens: name, aspect ratio, HiDPI, portrait, your own sizes and refresh rates. Connect with a display switches it on while one of the chosen displays is there.
  • A new virtual screen is placed next to your main display. With the lid closed or the display asleep, a virtual screen can become the main display.

Groups and tools

  • Displays in a group share brightness and, if you like, picture settings and interface size. Create groups under Settings › Groups.
  • The tools switch Dark mode, Night Shift, True Tone and Stay awake (no sleep and no screen saver), and open the filter and stream windows.

Keys and shortcuts

  • With Brightness keys and Volume keys on, the keys of your keyboard change the display under the pointer, the main display or all displays. This needs Accessibility. On each display's settings page, Keyboard controls this display leaves a display out.
  • Settings › Keyboard and OSD records shortcuts for brightness, volume, resolution, HiDPI, picture in picture, dark mode, Night Shift, identify and the next input. A small level shows on screen after each change.

Automation

  • Links: shortcuts, scripts and other apps can open mercurio-displays:// links, for example mercurio-displays://brightness?display=main&value=0.5. Links that disconnect, mirror or rotate a display or change its picture ask first, unless they carry the token from Settings › Automation.
  • Local web server: off until you switch it on. Only this Mac can reach it (address 127.0.0.1), and every request needs the token.
  • Command line: while the app is open, run its program with a command, for example "/Applications/Display Plus.app/Contents/MacOS/DisplayPlus" list; it prints the answer as JSON. Switch it on under Settings › Automation.

When something looks wrong

  • A screen went dark or looks strange: quit Display Plus (Quit in the menu, or ⌘Q while the menu is open). Quitting puts every display back: software dimming and colors return to normal, disconnected displays connect again and virtual screens go away. A monitor you dimmed over the cable keeps its own brightness; turn it up in its card or in the monitor's own menu. If the menu is out of reach, unplug and replug the display or log out and in again.
  • The brightness slider of a monitor does nothing: the monitor or the connection does not pass on DDC/CI. Try another port or cable, switch on DDC/CI in the monitor's own menu, or use software dimming, which the card falls back to.
  • The brightness keys change only the built-in display: allow Accessibility under System Settings › Privacy & Security › Accessibility, and check Keyboard controls this display on the display's settings page.
  • Picture in picture stays black: allow Screen Recording for Display Plus, then quit and open the app again.
  • A resolution keeps changing back: Protect settings may be holding the old one. Change the resolution in Display Plus, or switch protection off for that display.
  • A display is missing: click Detect displays on the Displays settings page, or Connect all if you disconnected it.

Buying and updates

Display Plus costs €17.99 once, with no subscription and no account. After payment you download it from the page Stripe sends you to; the link works for 30 days and you get a receipt by email. Lost the link? Write to hello@mercuriolabs.app with the email address you paid with. Updates come by email and through your download page.

Mac, macOS, Retina, XDR, Night Shift and True Tone are trademarks of Apple Inc. Display Plus is an independent app by Mercurio Labs and is not affiliated with Apple.