BetterDisplay: A repository from cneira

BetterDisplay

Custom Resolutions, XDR/HDR Extra Brightness, Virtual Screens, Picture in Picture, Display Disconnect, Display and EDID overrides & More!

_{Not on macOS Monterey or newer? Get the v1.x version (macOS Mojave and up)!}

About BetterDisplay

BetterDisplay is a truly wonderful tool! It lets you convert your displays to fully scalable screens, manage display configuration overrides, allows brightness and color control, provides XDR/HDR brightness upscaling (extra brightness beyond 100% for compatible XDR or HDR displays on Apple Silicon and Intel Macs - multiple methods available), full dimming to black, helps you create and manage virtual screens for your Mac, create Picture in Picture windows of your displays and gives you a host of other features to manage your display's settings easily from the menu bar. It can even disconnect/reconnect displays on-the-fly!

Key Features

Reach the full brightness potential of your XDR or HDR display - XDR brightness upscale to 1600 nits, external HDR display brightness upscale depending on the display's capability. Native XDR, color table (Apple Silicon) and Metal (Apple Silicon and Intel) methods are all supported. *
Native brightness upscaling for Apple XDR displays (built-in) - provides full unlock for the entire brightness range with no strings attached - no clipped or overblown HDR videos, full native sliders compatibility, no extra CPU/GPU usage. *
Change the display's brightness, volume and colors via software and hardware (DDC) control using sliders, native or custom keyboard shortcuts!
BetterDisplay is the only app currently with DDC control for all modern Macs (full DDC support for all Apple Silicon Macs including the M1 built-in HDMI ports, and 2018 mini built-in HDMI port).
Change display inputs using DDC on supported displays.
Option to auto-disconnect built-in screen upon connecting an external display - requires Apple Silicon (note: Settings/Displays/Overview/Connection management settings...). *
Convert your internal and natively connected external displays to flexible-scaled HiDPI displays using flexbile scaling (displays with notch, HDR, HDCP, high refresh rate are all supported)! *
Change the resolution easily with a slider!
Quickly accessible refresh rate and screen rotation menu.
Better quality zooming (System Preferences»Accessibility»Zoom) or High Quality screenshots even on 1080p displays.
Define favorite resolutions and reach them using the app menu, resolution slider or keyboard shortcuts. *
Create custom HiDPI resolutions for real displays manually. Redefine various system display parameters!
Disconnect and reconnect displays (removing them from the display layout and adding them back) on Apple Silicon (macOS Ventura or newer required) and Intel (all macOS version supported - on Intel the feature is considered experimental and can cause issues)! *
Protect display configuration (resolution, refresh rate/VRR, rotation, color profile). *
Color profile (and XDR Preset) selector.
Auto switch color profile for SDR and HDR modes. *
EDID override support for both Intel and Apple Silicon Macs! *
Export display EDID and show detailed display information (Intel and Apple Silicon).
Create any number of virtual screens with varying aspect ratios and resolutions.
Use headless Macs (servers) with any resolution and HiDPI mode for remote access.
Scaled Sidecar resolutions and portrait SideCar support (via virtual screen streaming). *
Use your iPad or monitor as a DIY Teleprompter. *
Enable Night Shift for your TV.
Help width display flickering (PWM, temporal dithering).
Create Picture in Picture window for any real display or virtual screen. *
Redirect your display's contents (real or virtual) to another screen with local streaming. *
Use the bottom half of your TV as a wide screen display (off-center streaming). *
Simplify creating mirrored sets. *
Easily move around displays relative to each other using the app menu.
Keyboard shortcuts for brightness and audio control.
Advanced keyboard shortcuts support. *
Various CLI and app integration features (command line, betterdisplaycli, custom URL schema, HTTP, notifications).
MacOS Shortcuts (App Intents) support for various operations.
MediaMate support for OSDs with fresh visuals (latest versions required for both apps). *

... and more is coming! :)

Note: features marked with an asterisk (*) require a Pro license.

For a list of free and Pro features and comparison to MonitorControl, click here...

Getting a Pro license to unlock all features

You can support development and unlock all features of the app by purchasing a Pro license for $18 / €18 (Sales Tax or VAT may also apply depending on selected territory). You can also get Pro inside the app - just navigate to Settings (gear icon) > Pro and click on Buy BetterDisplay Pro.

Please note that even if you don't buy the app, you can still use many of the features for free (if you are a non-business user). A 14-day trial is also available to fully evaluate BetterDisplay Pro before purchase.

More information on purchasing Pro & payment methods

For more information on licensing, trial, prices and refund, privacy, please read the License Terms & Conditions, Refund and Privacy Policy!

Please don't forget to star the GitHub page and spread the word about the app! :)

Installation

Install the app using one of the following methods:

Manual

Download the latest version
Open the .dmg file and move the app to /Applications folder.
Start the app from /Applications folder or from Launchpad / Spotlight.
Use the BetterDisplay icon in the menu bar to access the app's features.

Homebrew

Install Homebrew
Run brew install --cask betterdisplay

Using the App

The app contains detailed explanations for most features (under Settings - click the gear icon at the bottom of the app menu). Check out the Wiki section for more info on app usage.

If you have any questions, search for answers under Discussions and the BetterDisplay Discord channel (it has an extensive history and forum threads, most questions have been asked and answered several times over). If you don't find answers, feel free to create a new discussion or Discord forum thread!

Compatibility

The v2.x version of the app is compatible with all Apple Silicon and Intel Macs running macOS Sonoma, Ventura and the latest version of Monterey.
The v1.x app version is compatible with macOS Monterey, Big Sur, Catalina and Mojave.
XDR/HDR upscaling requires an Apple XDR display (built-in or external) or a natively connected external HDR display (VESA DisplayHDR 600 or higher recommended).
The display connect/disconnect feature requires an Apple Silicon Mac running at least macOS Ventura or an Intel Mac (all macOS versions supported - on Intel the feature is experimental only). External display sleep/suspend on disconnect is available only on Apple Silicon (on Intel, dimming or DDC backlight off is available for third party displays - backlight off works for Apple and built-in displays).
Flexible scaling requires macOS Monterey 12.4 (or newer) and natively connected displays. For Intel all macOS versions work.
Maximum flexible scaling resolutions depend on GPU capabilities and the display's resolution (horizontal width limit is 6144 pixels for entry level Apple Silicon Macs, 7680 pixels for the Pro/Max/Ultra versions).
External display hardware backlight control and volume control require DDC capable, natively connected display or an Apple display. Some docks and dongles may not support DDC. All built-in ports of all Macs that can run the app are supported for DDC communication.
The app is compatible with headless Macs to create custom virtual screen resolutions for remote access.

Discord Channel

You can join the discussion on the BetterDisplay Discord channel. If you have any issues or questions, don't hesitate to ask!

Localization

The app supports localization. Special thanks to everybody who has contributed and is contributing to the localization effort!

Check out the current localization status and on how to contribute!!

cneira/BetterDisplay