└── README.md


/README.md:
--------------------------------------------------------------------------------
  1 | <div align="center">
  2 | <a href="https://github.com/waydabber/BetterDisplay/releases"><img src="https://github.com/waydabber/BetterDisplay/assets/37590873/c9eaae81-78b8-4bd7-aeea-0ec445f1b0ea" width="280" alt="BetterDisplay" align="center"/></a>
  3 | 
  4 | <h2>BetterDisplay Pro</h2>
  5 | <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>
  6 | <a href="https://github.com/waydabber/BetterDisplay/releases/download/v3.5.5/BetterDisplay-v3.5.5.dmg"><img src="https://user-images.githubusercontent.com/37590873/219133640-8b7a0179-20a7-4e02-8887-fbbd2eaad64b.png" width="180" alt="Download for macOS"/></a><br/>
  7 | <sub><b>The <a href="https://github.com/waydabber/BetterDisplay/releases">latest app version</a> requires macOS Ventura, Sonoma or Sequoia.<br>
  8 | Legacy versions: </b>macOS Monterey - <a href="https://github.com/waydabber/BetterDisplay/releases/download/v2.3.9/BetterDisplay-v2.3.9.dmg">v2.3.9</a>, Mojave, Catalina, Big Sur - <a href="https://github.com/waydabber/BetterDisplay/releases/download/v1.4.15/BetterDisplay-v1.4.15.dmg">v1.4.15</a>.</sub>
  9 | </div>
 10 | 
 11 | <br />
 12 | 
 13 | <div align="center">
 14 | <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>
 15 | <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>
 16 | <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>
 17 | <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>
 18 | </div>
 19 | 
 20 | ## About BetterDisplay
 21 | 
 22 | **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!
 23 | 
 24 | <div align="center">
 25 | <img width="832" src="https://github.com/user-attachments/assets/0eaa18bf-d377-4ac2-ad81-b6dcd6abd158">
 26 | </div>
 27 | 
 28 | ## Key Features
 29 | 
 30 | - **NEW:** Video filters for PIP and local streaming. *
 31 | - **NEW:** Apply filters directly to your screen using self-streaming and video filter windows. *
 32 | - **NEW:** Control integration - control your device using shell scripts and URLs. *
 33 | - Color mode selector and unexposed refresh rates for Apple Silicon Macs** - change RGB, YCbCr, chroma subsampling, HDMI range settings.
 34 | - [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. Native XDR, color table (Apple Silicon) and Metal (Apple Silicon and Intel) methods are all supported. *
 35 | - [Native brightness upscaling for Apple XDR displays](https://github.com/waydabber/BetterDisplay/wiki/XDR-and-HDR-brightness-upscaling#enablingdisabling-hardware-native-xdr-upscaling-apple-silicon-intel-requires-apple-xdr-display) (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. *
 36 | - Display group and synchronization features - sync brightness and other image controls among multiple displays!
 37 | - Display UI scale matching - synchronize display UI scale / resolution among multiple displays (recommended for displays with flexible scaling enabled). *
 38 | - Layout protection - create and protect an adaptive display arrangement using anchor points for natural traversal among screens. *
 39 | - Change the display's brightness, volume and colors via software and hardware (DDC) control using sliders, native or custom keyboard shortcuts!
 40 | - DDC auto-configuaration** - automatically detect and configure DDC capabilities. Requires the [latest v3.x version](https://github.com/waydabber/BetterDisplay/releases).
 41 | - 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).
 42 | - Change display inputs using DDC on supported displays.
 43 | - Option to auto-disconnect built-in screen upon connecting an external display - requires Apple Silicon (note: Settings/Displays/Overview/Connection management settings...). *
 44 | - [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)! *
 45 | - Change the resolution easily with a slider!
 46 | - Quickly accessible refresh rate and screen rotation menu.
 47 | - Better quality zooming (`System Settings` > `Accessibility` > `Zoom`) or High Quality screenshots even on 1080p displays.
 48 | - Define favorite resolutions and reach them using the app menu, resolution slider or keyboard shortcuts. *
 49 | - Create custom HiDPI resolutions for real displays manually. Redefine various system display parameters!
 50 | - 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)! *
 51 | - Protect display configuration (resolution, refresh rate/VRR, rotation, color profile). *
 52 | - Color profile (and XDR Preset) selector.
 53 | - Auto switch color profile for SDR and HDR modes. *
 54 | - EDID override support for both Intel and Apple Silicon Macs! *
 55 | - Export display EDID and show detailed display information (Intel and Apple Silicon).
 56 | - Create any number of virtual screens with varying aspect ratios and resolutions.
 57 | - Use headless Macs (servers) with any resolution and HiDPI mode for remote access.
 58 | - [Scaled Sidecar resolutions and portrait SideCar support (via virtual screen streaming)](https://github.com/waydabber/BetterDisplay/wiki/Rotated-Sidecar). *
 59 | - [Use your iPad or monitor as a DIY Teleprompter](https://github.com/waydabber/BetterDisplay/wiki/DIY-teleprompter-flipped-screen). *
 60 | - [Enable Night Shift for your TV](https://github.com/waydabber/BetterDisplay/wiki/Enable-Night-Shift-for-televisions).
 61 | - [Help width display flickering (PWM, temporal dithering)](https://github.com/waydabber/BetterDisplay/wiki/Eye-care:-prevent-PWM-and-or-temporal-dithering).
 62 | - Create Picture in Picture window for any real display or virtual screen. *
 63 | - Redirect your display's contents (real or virtual) to another screen with local streaming. *
 64 | - Use the bottom half of your TV as a wide screen display (off-center streaming). *
 65 | - Simplify creating mirrored sets. *
 66 | - Easily move around displays relative to each other using the app menu.
 67 | - Keyboard shortcuts for brightness and audio control.
 68 | - Advanced keyboard shortcuts support. *
 69 | - [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).
 70 | - MacOS Shortcuts (App Intents) support for various operations.
 71 | - [MediaMate](https://wouter01.github.io/MediaMate/) support for OSDs with fresh visuals (latest versions required for both apps). *
 72 | 
 73 | ... [and more is coming](https://github.com/waydabber/BetterDisplay/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3Aenhancement)! :)
 74 | 
 75 | _Note: features marked with an asterisk (*) require a [Pro license](https://github.com/waydabber/BetterDisplay/wiki/Getting-a-Pro-License)._
 76 | 
 77 | [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)
 78 | 
 79 | ## Getting a Pro license to unlock all features
 80 | 
 81 | You can support development and unlock all features of the app by **[purchasing a Pro license for $19.99 / €19.99](https://betterdisplay.pro/buy)** (Currency may vary and Sales Tax or VAT may also apply depending on country/state). You can also get Pro inside the app - just navigate to `Settings` (gear icon) > `Pro` and click on `Buy BetterDisplay Pro`.
 82 | 
 83 | <div align="center">
 84 | <a href="https://betterdisplay.pro/buy"><img width="500" src="https://github.com/waydabber/BetterDisplay/assets/37590873/6a732657-1e72-4b98-91e6-7a56abb716d3"></a>
 85 | </div>
 86 | 
 87 | 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.
 88 | 
 89 | [More information on purchasing Pro & payment methods](https://github.com/waydabber/BetterDisplay/wiki/Getting-a-Pro-License)
 90 | 
 91 | 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)!
 92 | 
 93 | Please don't forget to star the GitHub page and spread the word about the app! :)
 94 | 
 95 | ## Installation
 96 | 
 97 | Install the app using one of the following methods:
 98 | 
 99 | ### Manual
100 | 1. Download the [latest version](https://github.com/waydabber/BetterDisplay/releases)
101 | 1. Open the `.dmg` file and move the app to `/Applications` folder.
102 | 1. Start the app from `/Applications` folder or from Launchpad / Spotlight.
103 | 1. Use the BetterDisplay icon in the menu bar to access the app's features.
104 | 
105 | ### Homebrew
106 | 1. Install [Homebrew](https://brew.sh/)
107 | 1. Run:
108 | ```bash
109 | brew install --cask betterdisplay
110 | ```   
111 | ## Using the App
112 | 
113 | 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.
114 | 
115 | 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!
116 | 
117 | ## Compatibility
118 | 
119 | - The latest v3.x version of the app is compatible with all **Apple Silicon** and **Intel** Macs running macOS **Sequoia**, **Sonoma**, **Ventura** (13.2 or newer).
120 | - The latest stable v2.x version of the app supports macOS **Sonoma**, **Ventura** and **Monterey** (12.4 or newer).
121 | - The v1.x app version is compatible with macOS **Monterey**, **Big Sur**, **Catalina** and **Mojave**.
122 | - 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).
123 | - 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).
124 | - Flexible scaling requires macOS Monterey 12.4 (or newer) and natively connected displays. For Intel all macOS versions work.
125 | - 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).
126 | - 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.
127 | - The app is compatible with headless Macs to create custom virtual screen resolutions for remote access.
128 | 
129 | ## Localization
130 | 
131 | The app supports localization. Special thanks to everybody who has contributed and is contributing to the localization effort!
132 | 
133 | [Check out the current localization status and on how to contribute…](https://github.com/waydabber/BetterDisplay/discussions/2165)
134 | 
135 | ## Contact & Discord Channel
136 | 
137 | Join the discussion on the [BetterDisplay Discord channel](https://discord.gg/aKe5yCWXSp). If you have any issues or questions, don't hesitate to ask!
138 | 
139 | 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).
140 | 


--------------------------------------------------------------------------------