# Repository: waydabber/BetterDisplay
# Stars: 31198

## README.md

<div align="center">
<a href="https://github.com/waydabber/BetterDisplay/releases"><img src="https://github.com/user-attachments/assets/3a3e7683-1bfc-4ba1-9a91-4a458488899f" width="290" height="290" alt="BetterDisplay" align="center"/></a>

<h2>BetterDisplay Pro</h2>
<p>Custom Resolutions, XDR/HDR Extra Brightness, Virtual Screens, Picture in Picture, Soft-Disconnect, Configuration and EDID overrides, DDC Control, Color Mode Selection, Syncing, Layout Protection and More!</p>
<a href="https://github.com/waydabber/BetterDisplay/releases/download/v4.2.3/BetterDisplay-v4.2.3.dmg"><img src="https://user-images.githubusercontent.com/37590873/219133640-8b7a0179-20a7-4e02-8887-fbbd2eaad64b.png" width="180" alt="Download for macOS"/></a><br/>
<sub>
<b>Download the <a href="https://github.com/waydabber/BetterDisplay/releases/download/v4.2.3/BetterDisplay-v4.2.3.dmg">current v4.x release</a> for macOS Tahoe 26, Sequoia, Sonoma, Ventura</b><br>
Previous versions: <a href="https://github.com/waydabber/BetterDisplay/releases/download/v3.5.6/BetterDisplay-v3.5.6b.dmg">v3.5.6</a> |
<a href="https://github.com/waydabber/BetterDisplay/releases/download/v2.3.9/BetterDisplay-v2.3.9.dmg">v2.3.9</a> - macOS Monterey |
<a href="https://github.com/waydabber/BetterDisplay/releases/download/v1.4.15/BetterDisplay-v1.4.15.dmg">v1.4.15</a> - Mojave, Catalina, Big Sur<br />
<a href="https://github.com/waydabber/BetterDisplay/releases">Browse all releases</a><br>
</sub>
</div>

<br />

<div align="center">
<a href="https://github.com/waydabber/BetterDisplay/releases"><img src="https://img.shields.io/github/downloads/waydabber/BetterDisplay/total.svg?style=flat&color=blue" alt="downloads"/></a>
<a href="https://github.com/waydabber/BetterDisplay/releases"><img src="https://img.shields.io/github/release/waydabber/BetterDisplay.svg?style=flat&color=blue&include_prereleases" alt="latest version"/></a>
<a href="https://github.com/waydabber/BetterDisplay/releases"><img src="https://img.shields.io/badge/platform-macOS-lightgrey.svg?style=flat&color=blue" alt="platform"/></a>
<a href="https://discord.gg/aKe5yCWXSp"><img src="https://img.shields.io/discord/903276571773771796?label=chat&style=flat&color=blue&logo=discord" alt="platform"/></a>
</div>

<br />

## 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** like display and color mode easily from the menu bar. It can even **disconnect/reconnect displays** on-the-fly!

<div align="center">
<img width="832" height="630" src="https://github.com/user-attachments/assets/c9c9be58-d86b-402e-bf33-a7ddfb5915bf" />
</div>

## Key Features

- **NEW:** Built-in LG webOS TV, Samsung Tizen TV, Philips Android TV and Yamaha AVR networked control support.
- [Reach the full brightness potential of your XDR or HDR display](https://github.com/waydabber/BetterDisplay/wiki/XDR-and-HDR-brightness-upscaling) - XDR brightness upscale to 1600 nits, external HDR display brightness upscale depending on the display's capability. Color table (Apple Silicon) and Metal (Apple Silicon and Intel) methods are all supported. *
- Color mode selector and unexposed refresh rates for Apple Silicon Macs** - change RGB, YCbCr, chroma subsampling, HDMI range settings.
- Display group and synchronization features - sync brightness and other image controls among multiple displays!
- Display UI scale matching - synchronize display UI scale / resolution among multiple displays (recommended for displays with flexible scaling enabled). *
- Layout protection - create and protect an adaptive display arrangement using anchor points for natural traversal among screens. *
- Change the display's brightness, volume and colors via software and hardware (DDC) control using sliders, native or custom keyboard shortcuts!
- Custom OSD styles with the option to bring back the classic OSD style on macOS Tahoe 26 reinterpreted for glass.
- DDC auto-configuaration** - automatically detect and configure DDC capabilities. Requires the [latest v3.x version](https://github.com/waydabber/BetterDisplay/releases).
- 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](https://github.com/waydabber/BetterDisplay/wiki/Fully-scalable-HiDPI-desktop) using flexbile scaling (displays with notch, HDR, HDCP, high refresh rate are all supported)! *
- Video filters for PIP and local streaming. *
- Apply filters directly to your screen using self-streaming and video filter windows. *
- Control integration - control your device using shell scripts and URLs. *
- Change the resolution easily with a slider!
- Quickly accessible refresh rate and screen rotation menu.
- Better quality zooming (`System Settings` > `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)](https://github.com/waydabber/BetterDisplay/wiki/Rotated-Sidecar). *
- [Use your iPad or monitor as a DIY Teleprompter](https://github.com/waydabber/BetterDisplay/wiki/DIY-teleprompter-flipped-screen). *
- [Enable Night Shift for your TV](https://github.com/waydabber/BetterDisplay/wiki/Enable-Night-Shift-for-televisions).
- [Help width display flickering (PWM, temporal dithering)](https://github.com/waydabber/BetterDisplay/wiki/Eye-care:-prevent-PWM-and-or-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](https://github.com/waydabber/BetterDisplay/wiki/Integration-features,-CLI) (command line, [betterdisplaycli](https://github.com/waydabber/betterdisplaycli), custom URL schema, HTTP, notifications).
- MacOS Shortcuts (App Intents) support for various operations.

... [and more is coming](https://github.com/waydabber/BetterDisplay/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3Aenhancement)! :)

_Note: features marked with an asterisk (*) require a [Pro license](https://github.com/waydabber/BetterDisplay/wiki/Getting-a-Pro-License)._

[For a list of free and Pro features and comparison to MonitorControl, click here...](https://github.com/waydabber/BetterDisplay/wiki/List-of-free-and-Pro-features)

## Getting a Pro license to unlock all features

You can support development and unlock all features by **[purchasing a Pro license at betterdisplay.pro](https://betterdisplay.pro)**, the app's official site ($21.99 / €19.99 — price, currency, and taxes may vary by country or state). You can also get Pro inside the app - just navigate to `Settings` (gear icon) > `Pro` and click on `Buy BetterDisplay Pro`.

With a Pro license, you’ll get full access to the current main version of the app (and all previous versions if needed for compatibility). Your purchase also includes at least one year of free updates — including any major upgrades released during that time. Best of all, the Pro license is perpetual (not a subscription), so the versions you unlock are yours to keep and use.

<div align="center">
<a href="https://betterdisplay.pro/#buy"><img width="500" src="https://github.com/waydabber/BetterDisplay/assets/37590873/6a732657-1e72-4b98-91e6-7a56abb716d3"></a>
</div>

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](https://github.com/waydabber/BetterDisplay/wiki/Getting-a-Pro-License)

For more information on licensing, trial, prices and refund, privacy, please read the [License Terms & Conditions, Refund and Privacy Policy](https://github.com/waydabber/BetterDisplay/discussions/739)!

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
1. Download the [latest version](https://github.com/waydabber/BetterDisplay/releases)
1. Open the `.dmg` file and move the app to `/Applications` folder.
1. Start the app from `/Applications` folder or from Launchpad / Spotlight.
1. Use the BetterDisplay icon in the menu bar to access the app's features.

### Homebrew
1. Install [Homebrew](https://brew.sh/)
1. Run:
```bash
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](https://github.com/waydabber/BetterDisplay/wiki) for more info on app usage.

If you have any questions, search for answers under [Discussions](https://github.com/waydabber/BetterDisplay/discussions) and the BetterDisplay [Discord channel](https://discord.gg/aKe5yCWXSp) (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 current v4.x version of the app is compatible with all **Apple Silicon** and **Intel** Macs running **macOS Tahoe 26**, **Sequoia**, **Sonoma** and **Ventura** (13.2 or newer).
- The v3.5.6 version of the app supports **macOS Sequoia**, **Sonoma** and **Ventura** (13.2 or newer).
- The latest stable v2.3.9 version of the app supports **macOS Sonoma**, **Ventura** and **Monterey** (12.4 or newer).
- The v1.4.5 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.

### Third party notch app integration support

The following third party notch apps support BetterDisplay using its [OSD integration API](https://github.com/waydabber/BetterDisplay/wiki/Integration-features,-CLI#osd-notification-dispatch-integration):

- [MediaMate](https://wouter01.github.io/MediaMate/) - support available
- [DynamicLake](https://www.dynamiclake.com) - support available
- [Alcove](https://tryalcove.com) - support available
- [Atoll](https://getatoll.app) - support available
- [BoringNotch](https://theboring.name) - support [work in progress](https://github.com/TheBoredTeam/boring.notch/issues/943)

### Raycast extension

If you use [Raycast](https://raycast.com), a [BetterDisplay extension](https://www.raycast.com/pascal_burkhard/betterdisplay) is available for interacting with BetterDisplay.

## 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…](https://github.com/waydabber/BetterDisplay/discussions/2165)

## Contact & Discord Community Server

Please check out the official homepage - https://betterdisplay.pro

Join the discussion on the [BetterDisplay Discord Community Server](https://discord.gg/aKe5yCWXSp) (you can also search for BetterDisplay under Discover/Servers). If you have any issues or questions, don't hesitate to ask!

The app is being developed by [@waydabber](https://github.com/waydabber) at [Kodeon Software](https://kodeonsoftware.com). The app's reseller is Paddle - regarding purchase related issues, please contact [Paddle Support](https://www.paddle.com). The best way **to get technical help or directly contact the developer is through the app's [Discord channel](https://discord.gg/aKe5yCWXSp)**. Alternatively you can send an email to <span>info<i>&#64;</i>kodeon</span>software<i>&#46;</i><span>com</span> - but this contact is strictly for licensing related issues (tech help is available via Discord).