v2.2.2

About this version

This version contains updates to the CLI/integration features, adds initial App Intents (macOS Shortcuts) support, some additional software image adjustment controls and contains various bug fixes and improvements to existing features, including the recently introduced native XDR upscaling.

Enhancements

• For CLI access you can now use betterdisplaycli as well (follow install instructions in the provided link).
• Added r/g/b gain controls for software control (both for color table and Metal overlay) - #2610
• Added gain slider for Metal overlay - #2587
• Added color temperature slider for Metal overlay - #2556
• Added integration commands to query pro features availability + toggle some integration and OSD features (allows MediaMate to better configure BetterDisplay) - #2532
• Added value normalization feature for integration when using controls (+allow mediaMate to more easily send control values) - #2537
• Added CLI command to list displays and virtual screens with identifiers - #2601
• Added CLI features to manage virtual screens - #2521
• Added r/g/b gain controls to CLI - #2613
• Added CLI deviceType option to filter displays and virtual screens - #2614
• General Shortcuts (macOS) support with App Intents - #1395
• Added App Intents (Shortcuts app) to change brightness for individual and all displays - #2617
• Added App Intent (Shortcuts app) to change DDC volume for a specified display - #2618
• Added App Intent (Shortcuts app) to change any of the additional software and hardware ranged controls for a specified display - #2619
• Added App Intent (Shortcuts app) to change any of the additional software and hardware ranged control offset value for a specified display - #2620
• Make the role of BetterDisplay XDR option under XDR Preset menu a bit more obvious by adding some explanation - #2576
• Added a toggle to always use Metal for some image adjustments when color table adjustments are not supported - #2591
• Disable the "Detected Some Interference" popup by default (can be re-enabled for troubleshooting) - #2586
• VMM7100 HDMI dongle no signal workaround (note: needs Terminal activation, see details in the linked issue) - #2609
• Improved support for M3 MacBooks - #2597
• General efficiency and licence management improvements

Fixed

• Overriding lower and upper bound of native XDR upscaling does not work properly until an app restart - #2575
• BetterDisplay XDR profile can be "untoggled" with a repeated click under XDR Profile (does nothing though) - #2577
• Display association does not show the associated display's name - #2582
• If a display is set to be forgotten, virtual screen display associations are not updated - #2583
• Various unlocalizable texts are still present in the app - #2596
• CLI provides wrong exit code (failure instead of success) even for working operations when there is no return payload. - #2598

Localizations included in this release

• Chinese, Simplified (96%) - @BingoKingo
• German (10%) - @mickimnet, @dotWee
• Hungarian (98%) - @sup3rb3ar
• Japanese (98%) - @SakiPapa
• Korean (71%) - @hw0603
• Portugese (Brazil) (91%) - @gpnunes75
• Romanian (86%) - @mikevic18
• Russian (16%) - @dimaitre
• Spanish (63%) - @stonkol
• Swedish (58%) - @yeager
• Turkish (44%) - @MazlumSerbest, @ibrayd
• Ukrainian (95%) - @JulyIghor
• Vietnamese (13%) - @andrwmai

You can change the app's language under System Settings > General > Language & Region > Applications.

Information on how to participate in the localization effort

For changes in previous versions take a look at the GitHub Releases page.

v2.2.1

About this version

This version contains updates to the CLI/integration feature introduced in the previous release and some other improvements and bug fixes. As major new features, the update adds two additional XDR/HDR brightness upscaling methods:

• Native XDR brightness upscaling - works with Apple XDR displays (built-in). Unlocks the entire brightness range with no strings attached - no clipped or overblown HDR videos, full native sliders compatibility, no extra CPU/GPU usage. To activate the feature, select BetterDisplay XDR under the XDR Preset menu under the display's app menu block. Set up auto-activation for a particular display under Settings > Displays.
• Metal XDR/HDR brightness upscaling - activated when native XDR or (the default) software upscaling methods are unavailable. Works on Intel Macs too with external HDR or XDR displays. Requires HDR to be enabled (on third party displays) and Color table adjustments option to be disabled under the display's settings to work.

See also: detailed info on how various XDR/HDR upscaling methods supported by the app work

Enhancements

• Added native XDR brightness upscaling with unclipped HDR video - #2536
• Added overlay Metal filter based HDR upscaling method as a fallback option - #2539
• Enabled Metal HDR upscaling for Intel - #2566
• Added zooming option to streaming - magnify, reduce, can be off-centered with snap controls - #2547
• Added 1:1 pixel mapped scaling (no-scaling) option for streaming - #1949
• Restructure CLI command syntax to be a bit more simple to use (while retaining compatibility with earlier style) - #2524
• Added option to show Color Profile selector for XDR displays as well - #2531
• Added self-serve license deactivation with key and activation id to CLI license management - #2523
• Added option to detach from brightness keys when only a display with native controls is present with all software control disabled - #2544
• Move Quit button to under Tools menu (with option to revert) + ability to hide Quit altogether - #2551
• Show Metal device name under display info section (useful on Intel with eGPUs) - #2562
• Combined brightness should not be enabled by default when native XDR upscaling is enabled - #2545
• Added options to tweak native XDR upscaling ranges - #2546
• Make combined brightness work with Metal overlay upscaling as well - #2561
• Improved performance of CLI integration - #2552
• Localization updates (see details below)

Fixed

• App crash on wake (NSBezierPath bug) - #2543
• The integrated CLI help has various typos and errors - #2529
• BetterDisplay does not recognize some custom presets as XDR upscaling capable - #2535
• Overlay dimming does not apply properly to full screen applications - #2554
• When enabling/disabling color adjustments, the software brightness slider is not updating properly - #2558
• XDR/HDR upscaling calibration slider does not respond beyond existing maximum calibrated brightness value - #2560
• Increasing XDR screen brightness via macOS can overblow XDR upscaling in non-combined mode - #2563
• When a CLI command is not understood, the app is launching a second copy of the app instead of giving some error message - #2553

Localizations included in this release

• Chinese, Simplified (95%) - @BingoKingo
• German (10%) - @mickimnet, @dotWee
• Hungarian (29%) - @sup3rb3ar
• Japanese (96%) - @SakiPapa
• Korean (74%) - @hw0603
• Portugese (Brazil) (95%) - @gpnunes75
• Romanian (90%) - @mikevic18
• Russian (17%) - @dimaitre
• Spanish (65%) - @stonkol
• Swedish (60%) - @yeager
• Turkish (21%) - @MazlumSerbest
• Ukrainian (95%) - @JulyIghor

You can change the app's language under System Settings > General > Language & Region > Applications.

Information on how to participate in the localization effort

For changes in previous versions take a look at the GitHub Releases page.

v2.2.0

About this version

This version adds a number of app integration options: CLI (command line), HTTP (via an embedded lightweight server), custom URL scheme and notification dispatch methods are supported.

Please note that the new app integration features are experimental: currently only a subset of BetterDisplay features are accessible via CLI/integration (the goal is to provide full access to all features) and the command syntax is subject to change in subsequent releases as the feature evolves!

As an additional Pro feature, this version supports integration with other OSD rendering apps, such as MediaMate (the latest version is required - enable BetterDisplay under General > Event Mode in MediaMate).

This version also adds CLI license management features (useful for scripted deployment, activation, deactivation) and contains various other improvements and bug fixes.

Enhancements

• External OSD replacement app support - MediaMate 3.0 and newer - #2143
• Separate DDC mute and unmute keyboard shortcut - #2453
• Add option to hide app OSDs - #2447
• Make Settings icons slightly more colorful to aid the eye - #2519
• Traditional command line integration (CLI) - #2445
• CLI based license management (volume deployment) - #2007
• Add HTTP based integration with customizable port - #2420
• Add custom URL scheme to control app functions - #2398
• Add security token for URL integration - #2399
• Add integration feature for setting ranged values - #2402
• Add x-callback-url support for custom URL scheme integration - #2403
• Verbose log out to stderr using the -v2e parameter (use -v for stdout) - #2464
• Flexible display addressability for integration - #2467
• Add integration feature for toggling various display and application settings or performing changes - #2483
• Add keyboard shortcut for toggling display notch - #2485
• Add ability to get the current, min and max value for a setting using CLI/HTTP/custom URL schema - #2486
• Add CLI option to change a ranged setting's value using an offset (increment/decrement) - #2488
• Add in-app help for CLI options + autodocumentation - #2494
• Add dynamic display identification options for CLI - current display with mouse or with focus - #2509
• Add CLI/integration features for issuing direct DDC commands - #2517
• Distributed Notification Center based integration possibility - #2446
• General efficiency and compatibility improvements

Fixed

• Combined brightness is not available when hardware backlight on/off control is disabled under DDC Features - #2512
• Custom displayed name shows a wrong default Color LCD for built-in displays - #2492

Localizations included in this release

• Chinese, Simplified (100%) - @BingoKingo
• German (6%) - @mickimnet
• Japanese (99%) - @SakiPapa
• Korean (78%) - @hw0603
• Portugese (Brazil) (99%) - @gpnunes75
• Romanian (94%) - @mikevic18
• Russian (17%) - @dimaitre
• Spanish (69%) - @stonkol
• Swedish (62%) - @yeager
• Turkish (21%) - @MazlumSerbest

You can change the app's language under System Settings > General > Language & Region > Applications.

Information on how to participate in the localization effort

v2.1.3

About this version

This version adds color profile and XDR preset related features, various other improvements and bug fixes.

Enhancements (compared to the last stable version v2.0.11)

• Added Color Profile selector menu - #1206
• Added XDR Presets listing and selection for XDR displays (these do not support color profile selection) - #2263
• Configuration protection and SDR and HDR auto-switch for color profiles - #1210
• XDR display preset awareness for colortable dimming and XDR upscaling - #2262
• XDR/HDR brightness upscaling calibrator for XDR screens - #2257
• Added option to change menu app animation speed (or disable animations) and option to disable icon bounce and popup animation - #2341
• Added various additional options to identify display by Vendor, Model ID, Product Name (but not by serial number and other extended identifiers) - #2338
• Deleting a virtual screen should delete its corresponding color profile - #1487
• Added option to remove factory color profiles upon discarding all virtual screens at once - #2374
• Show XDR display configuration under Display Information... - #2347
• Make remembered display information available under Display Information... for disconnected virtual screens - #2363
• Added Color Profile and XDR Preset selector menus to menu customization settings - #2345
• Backend for managing color profiles and XDR presets - #2297
• Added keyboard shortcut for 'Reinitialize External Displays' - #2384
• Updated Paddle framework to version v4.4.3 - #2394
• Add Custom SF Symbols Icon Set for Virtual Screens - #2426
• App argument -v to enable verbose logging - #2397
• Added partial Swedish localization - #2421
• Added partial Korean localization - #2245
• Added partial Russian localization - #2415
• Improved compatibility with M3 Macs and macOS Sonoma
• Various bug fixes and improvements

Fixed (compared to the last stable version v2.0.11)

• Custom virtual screen icon color scheme looks inverted in the Settings page + not shown as main display app icon in the menu bar - #2430
• Built-in display dimmed on wake on certain configurations (probably saved during dark wake period) - #2406
• There is a leading space in the Color Profile section of Display Information... - #2433
• App menu icon not updating immediately when it is set to match main display icon and the main display SF icon is changed - #2434
• Usability: DDC Features... edited field is not committed when pressing Done instantly without committing the field with an ENTER or TAB - #2410
• Display tag id and display UUID erroneously presented under a virtual screen in Settings/Displays - #2428
• If an expandable submenu is set to hidden under Settings/Menu when it is currently open, the display submenu becomes inaccessible - #2346
• Some interpreted dictionary labels parsed incorrectly under Display Information... - #2350
• Missing parenthesis when showing Config Protection HDR State - #2377
• Color adjustments go wrong on ColorSync profile change - #2379

Localizations included in this release

• Chinese, Simplified (v2.1.1, 100%) - @BingoKingo, @hshsilver
• German (v2.0.11, 6%) - @mickimnet, @philipbrembeck
• Japanese (v2.1.1, 100%) - @SakiPapa
• Korean (v2.1.1, 79%) - @Ryan-Dia, @hw0603
• Portugese (Brazil) (v2.0.11, 100%) - @gpnunes75
• Romanian (v2.0.11, 98%) - @mikevic18
• Russian (v2.1.3, 17%) - @dimaitre
• Swedish (38%) - @yeager

You can change the app's language under System Settings > General > Language & Region > Applications. For more information on how to participate in the localization effort: #2165

Detailed change log of v2.1.x versions

v2.1.3

• Added partial Russian localization - #2415
• Fixed: App crashes when licensing is disabled in v2.1.x - #2438

v2.1.2

• Fixed: Custom virtual screen icon color scheme looks inverted in the Settings page + not shown as main display app icon in the menu bar - #2430
• Fixed: Built-in display dimmed on wake on certain configurations (probably saved during dark wake period) - #2406
• Fixed: Colorsync profile list update might crash the app (memory allocation issue) in v2.1.x - #2432
• Fixed: There is a leading space in the Color Profile section of Display Information... - #2433
• Fixed: App menu icon not updating immediately when it is set to match main display icon and the main display SF icon is changed - #2434

v2.1.1

• App argument -v to enable verbose logging - #2397
• Add Custom SF Symbols Icon Set for Virtual Screens - #2426
• Added partial Swedish localization - 2421
• Added partial Korean localization - 2245
• Fixed: Devices with multiple custom color profiles are not properly handled in v2.1.0 - #2409
• Fixed: Usability: DDC Features... edited field is not committed when pressing Done instantly without committing the field with an ENTER or TAB - #2410
• Fixed: Display tag id and display UUID erroneously presented under a virtual screen in Settings/Displays - #2428

v2.1.0

• Added Color Profile selector menu - #1206
• Added XDR Presets listing and selection for XDR displays (these do not support color profile selection) - #2263
• Configuration protection and SDR and HDR auto-switch for color profiles - #1210
• XDR display preset awareness for colortable dimming and XDR upscaling - #2262
• XDR/HDR brightness upscaling calibrator for XDR screens - #2257
• Added option to change menu app animation speed (or disable animations) and option to disable icon bounce and popup animation - #2341
• Added various additional options to identify display by Vendor, Model ID, Product Name (but not by serial number and other extended identifiers) - #2338
• Deleting a virtual screen should delete its corresponding color profile - #1487
• Added option to remove factory color profiles upon discarding all virtual screens at once - #2374
• Show XDR display configuration under Display Information... - #2347
• Make remembered display information available under Display Information... for disconnected virtual screens - #2363
• Added Color Profile and XDR Preset selector menus to menu customization settings - #2345
• Backend for managing color profiles and XDR presets - #2297
• Added keyboard shortcut for 'Reinitialize External Displays' - #2384
• Updated Paddle framework to version v4.4.3 - #2394
• Improved compatibility with M3 Macs and macOS Sonoma
• Various bug fixes and improvements
• Fixed: If an expandable submenu is set to hidden under Settings/Menu when it is currently open, the display submenu becomes inaccessible - #2346
• Fixed: Some interpreted dictionary labels parsed incorrectly under Display Information... - #2350
• Fixed: Missing parenthesis when showing Config Protection HDR State - #2377
• Fixed: Color adjustments go wrong on ColorSync profile change - #2379

v2.1.2

About this version

This version is about bug fixes.

Fixed (compared to the last stable version v2.0.11)

• Custom virtual screen icon color scheme looks inverted in the Settings page + not shown as main display app icon in the menu bar - #2430
• Built-in display dimmed on wake on certain configurations (probably saved during dark wake period) - #2406
• Colorsync profile list update might crash the app (memory allocation issue) in v2.1.x - #2432
• There is a leading space in the Color Profile section of Display Information... - #2433
• App menu icon not updating immediately when it is set to match main display icon and the main display SF icon is changed - #2434

Detailed change log of v2.1.x versions

v2.1.2

• Fixed: Custom virtual screen icon color scheme looks inverted in the Settings page + not shown as main display app icon in the menu bar - #2430
• Fixed: Built-in display dimmed on wake on certain configurations (probably saved during dark wake period) - #2406
• Fixed: Colorsync profile list update might crash the app (memory allocation issue) in v2.1.x - #2432
• Fixed: There is a leading space in the Color Profile section of Display Information... - #2433
• Fixed: App menu icon not updating immediately when it is set to match main display icon and the main display SF icon is changed - #2434

v2.1.1

• App argument -v to enable verbose logging - #2397
• Add Custom SF Symbols Icon Set for Virtual Screens - #2426
• Added partial Swedish localization - 2421
• Added partial Korean localization - 2245
• Fixed: Devices with multiple custom color profiles are not properly handled in v2.1.0 - #2409
• Fixed: Usability: DDC Features... edited field is not committed when pressing Done instantly without committing the field with an ENTER or TAB - #2410
• Fixed: Display tag id and display UUID erroneously presented under a virtual screen in Settings/Displays - #2428

v2.1.0

• Added Color Profile selector menu - #1206
• Added XDR Presets listing and selection for XDR displays (these do not support color profile selection) - #2263
• Configuration protection and SDR and HDR auto-switch for color profiles - #1210
• XDR display preset awareness for colortable dimming and XDR upscaling - #2262
• XDR/HDR brightness upscaling calibrator for XDR screens - #2257
• Added option to change menu app animation speed (or disable animations) and option to disable icon bounce and popup animation - #2341
• Added various additional options to identify display by Vendor, Model ID, Product Name (but not by serial number and other extended identifiers) - #2338
• Deleting a virtual screen should delete its corresponding color profile - #1487
• Added option to remove factory color profiles upon discarding all virtual screens at once - #2374
• Show XDR display configuration under Display Information... - #2347
• Make remembered display information available under Display Information... for disconnected virtual screens - #2363
• Added Color Profile and XDR Preset selector menus to menu customization settings - #2345
• Backend for managing color profiles and XDR presets - #2297
• Added keyboard shortcut for 'Reinitialize External Displays' - #2384
• Updated Paddle framework to version v4.4.3 - #2394
• Improved compatibility with M3 Macs and macOS Sonoma
• Various bug fixes and improvements
• Fixed: If an expandable submenu is set to hidden under Settings/Menu when it is currently open, the display submenu becomes inaccessible - #2346
• Fixed: Some interpreted dictionary labels parsed incorrectly under Display Information... - #2350
• Fixed: Missing parenthesis when showing Config Protection HDR State - #2377
• Fixed: Color adjustments go wrong on ColorSync profile change - #2379

v2.1.1

About this version

This pre-release version adds various color profile and XDR preset related features and some other improvements and bug fixes.

Enhancements

• App argument -v to enable verbose logging - #2397
• Add Custom SF Symbols Icon Set for Virtual Screens - #2426
• Added partial Swedish localization - #2421
• Added partial Korean localization - #2245

Fixed

• Devices with multiple custom color profiles are not properly handled in v2.1.0 - #2409
• Usability: DDC Features... edited field is not committed when pressing Done instantly without committing the field with an ENTER or TAB - #2410
• Display tag id and display UUID erroneously presented under a virtual screen in Settings/Displays - #2428

Change log of previous v2.1.x versions

v2.1.1

• App argument -v to enable verbose logging - #2397
• Add Custom SF Symbols Icon Set for Virtual Screens - #2426
• Added partial Swedish localization - 2421
• Added partial Korean localization - 2245
• Fixed: Devices with multiple custom color profiles are not properly handled in v2.1.0 - #2409
• Fixed: Usability: DDC Features... edited field is not committed when pressing Done instantly without committing the field with an ENTER or TAB - #2410
• Fixed: Display tag id and display UUID erroneously presented under a virtual screen in Settings/Displays - #2428

v2.1.0

• Added Color Profile selector menu - #1206
• Added XDR Presets listing and selection for XDR displays (these do not support color profile selection) - #2263
• Configuration protection and SDR and HDR auto-switch for color profiles - #1210
• XDR display preset awareness for colortable dimming and XDR upscaling - #2262
• XDR/HDR brightness upscaling calibrator for XDR screens - #2257
• Added option to change menu app animation speed (or disable animations) and option to disable icon bounce and popup animation - #2341
• Added various additional options to identify display by Vendor, Model ID, Product Name (but not by serial number and other extended identifiers) - #2338
• Deleting a virtual screen should delete its corresponding color profile - #1487
• Added option to remove factory color profiles upon discarding all virtual screens at once - #2374
• Show XDR display configuration under Display Information... - #2347
• Make remembered display information available under Display Information... for disconnected virtual screens - #2363
• Added Color Profile and XDR Preset selector menus to menu customization settings - #2345
• Backend for managing color profiles and XDR presets - #2297
• Added keyboard shortcut for 'Reinitialize External Displays' - #2384
• Updated Paddle framework to version v4.4.3 - #2394
• Improved compatibility with M3 Macs and macOS Sonoma
• Various bug fixes and improvements
• Fixed: If an expandable submenu is set to hidden under Settings/Menu when it is currently open, the display submenu becomes inaccessible - #2346
• Fixed: Some interpreted dictionary labels parsed incorrectly under Display Information... - #2350
• Fixed: Missing parenthesis when showing Config Protection HDR State - #2377
• Fixed: Color adjustments go wrong on ColorSync profile change - #2379

v2.1.0-pre-release

About this pre-release version

This pre-release version adds various color profile and XDR preset related features and some other improvements and bug fixes.

Enhancements

• Added Color Profile selector menu - #1206
• Added XDR Presets listing and selection for XDR displays (these do not support color profile selection) - #2263
• Configuration protection and SDR and HDR auto-switch for color profiles - #1210
• XDR display preset awareness for colortable dimming and XDR upscaling - #2262
• XDR/HDR brightness upscaling calibrator for XDR screens - #2257
• Added option to change menu app animation speed (or disable animations) and option to disable icon bounce and popup animation - #2341
• Added various additional options to identify display by Vendor, Model ID, Product Name (but not by serial number and other extended identifiers) - #2338
• Deleting a virtual screen should delete its corresponding color profile - #1487
• Added option to remove factory color profiles upon discarding all virtual screens at once - #2374
• Show XDR display configuration under Display Information... - #2347
• Make remembered display information available under Display Information... for disconnected virtual screens - #2363
• Added Color Profile and XDR Preset selector menus to menu customization settings - #2345
• Backend for managing color profiles and XDR presets - #2297
• Added keyboard shortcut for 'Reinitialize External Displays' - #2384
• Updated Paddle framework to version v4.4.3 - #2394
• Improved compatibility with M3 Macs and macOS Sonoma
• Various bug fixes and improvements

Fixed

• If an expandable submenu is set to hidden under Settings/Menu when it is currently open, the display submenu becomes inaccessible - #2346
• Some interpreted dictionary labels parsed incorrectly under Display Information... - #2350
• Missing parenthesis when showing Config Protection HDR State - #2377
• Color adjustments go wrong on ColorSync profile change - #2379

v2.0.11

About this version

This version provides improved compatibility with the initial release of macOS Sonoma and contains some minor enhancements/fixes based on the feedback received for the previous version.

Enhancements

• Added option to enable/disable dock icon or just show it when Settings is opened (default) - #2228
• Added an option whether the app puts itself into the macOS Dock's recent items on startup (off by default) - #2227
• The app now uniformly opens Settings when clicking on the dock icon or relaunching the app while the app is already running - #2229
• Added shortcut button to Settings to open app menu - even when the app menu is hidden - #2238
• Added option to force an underscan slider for native display connections on Apple Silicon - #2236

Fixed

• "Dim display on screen saver or lock" might not restore full brightness after sleep/wake - #2225
• Displays with "turn off display backlight on screen saver or lock" might not have their backlight restored properly at wake - #2241
• Slowly waking display might not load its configuration due to the Sonoma configuration bug even with "Reinitialize external displays with smooth scaling enabled" turned on - #2240
• "Redetect displays" has missing icon on Monterey/Ventura - #2242

Localizations included in this release

• Chinese, Simplified - 100% - @BingoKingo
• English - 100% - @waydabber (language of app development)
• German - 6% - @mickimnet, @philipbrembeck
• Japanese- 100% - @SakiPapa
• Portugese (Brazil) - 100% - @gpnunes75
• Romanian - 98% - @mikevic18

Note: you can change the app's language under System Settings > General > Language & Region > Applications.

Change log of previous v2.0.x versions

v2.0.10

• Added Portuguese (Brazil) localization (thanks to @gpnunes75)
• Added Romanian localization (thanks to @mikevic18)
• Added option to limit Apple and third party display hardware brightness control range for combined brightness control (this helps avoid PWM for those who are sensitive to it) - #1946
• Added option to customize sub-hardware-dimming and XDR/HDR upscale point for the display - #637
• Added standard menu with Edit submenu for Settings to allow general clipboard operations in text fields - #2188
• Show app menu dock icon while Settings is open + proper Command+TAB and Stage Manager support for the Settings window - #2167
• Improve handling default resolution on Intel Macs when system configuration editing and custom resolutions are enabled (requires re-running configuration edit) - #2200
• Auto-start PIP window when it is configured on app managed connect as well - #2187
• Auto-resume full-screen streaming - #1368
• Added "Redetect displays" option to the Tools menu - #2182
• Aggressive disconnect - option to auto-disconnect a display upon detection (or restore disconnect state upon app startup) - #1846
• Try to initiate screen recording permissions workflow in System Settings when virtual screen is configured for streaming and permission is missing - #2178
• Improved support for DisplayLink displays in v2.x (automatic handling of changing UUID issue for Apple Silicon) - #2148
• Added option to change default display identification method - #2179
• Added back mirror configuration option to virtual screen creation workflow (now only stream configuration is there) in v2.x - #2149
• Menu header of disconnected device should not respond to clicks (to silently open/close the menu) - #2196
• Added "Unknown Display" display type for unknown displays - #2203
• Auto-forget displays after a while with customizable number of days and different rememberance time for unknown Generic Displays - #2169
• Added information about a display's first connection, last connection and last unseen date in Display Information
• Added "Don't show again!" option to "The app is already running..." message on relaunch and go straight to opening the app menu - #2211
• Faster and more advanced display override on-the-fly activation for external displays - #2212
• Added option to re-initialize external displays (helps counter Sonoma custom display configuration bug) - #2204
• Fixed: External display custom system configuration does not load properly on Sonoma after display detection - #2218
• Fixed: Virtual screen workflow creation alert texts not presented properly - #2177
• Fixed: Some menu icons aren't centered when in LoDPI mode - #2195
• Fixed: If the display header menu toggle is set to something other than connect/disconnect but connect/disconnect is supported, the relevant - menu option does not appear - #2197
• Fixed: If the app menu is already open on a screen and the user clicks the menu bar button on an other display, the app menu closes instantly - after transported to the other screen - #2202
• Fixed: App menu tends to go jump around endlessly when the current screen's orientation is changed - #2217

v2.0.9

• Added general localization support to the app - #1343
• Added Chinese, Simplified localization - #2145
• Added Japanese localization thanks to - #2145
• Added toggle to turn Notch area on/off on Liquid Retina displays (MacBooks) - #2102
• Fixed: Custom app menu icon and "match menu icon with main display icon" does not apply upon app start (need to toggle the on/off switch) - #2133
• Fixed: Dividers look overemphasized on callout style submenus on Ventura - #2134
• Fixed various typos - #2138

v2.0.8

• Added option for a floating submenu style option instead of expanding submenu style - #2128
• Fixed: Improperly shaped keyboard ring appears in app menu and Settings when "Full Keyboard Access" accessibility is enabled - #2124
• Fixed: Detached app menu: with a transparency level of 100%, I would expect the detached menu to be opaque, and it is not - #2125
• Fixed: DDC Input configuration menu visibility dropdown issue - #2126
• Fixed: Virtual screen does not auto-connect when created as associated to a display but full-screen stream is not configured - #2131

v2.0.7

• Animations to PIP and full screen stream transormations - #2100
• Added warning about stream auto-start for associated display in Virtual Screen Stream menu - #2121
• Added warning about enforced mirror for associated display in Virtual Screen Mirror menu - #2120
• Fixed: Associated virtual screens should have a disabled disconnect toggle in the menu header instead of a live one (v2.0.6) - #2097
• Fixed: Flip and Rotate settings do not apply properly on Stream start (v2.0.6) - #2098
• Fixed: Empty Image Adjustments menu appears on a mirror target display with no colortable support - #2099
• Fixed: Animations to PIP and full screen stream transormations - #2100
• Fixed: Resolution slider setting changes do not take effect in the app menu instantly - #2103
• Fixed: Detachable app menu transparency level option should be disabled when the menu is not detachable - #2104
• Fixed: A favorite added using the Display Mode menu does not immediately appear on the Resolution Slider - #2105
• Fixed: Resolution selection/"Limit resolution slider and keyboard shortcut range" option does not immediately affect resolution slider - #2107
• Fixed: When invoking Settings UI from the menu, the menu does not always close (possibly covering Settings) when not detached - #2111
• Fixed: "Show slider markers only while dragging the knob" toggle works in reverse - #2114
• Fixed: When the app is already running and the menu is detached, starting the app again puts the menu into a mixed/invalid state - #2116
• Fixed: Some advanced association settings show up inverted in the Settings UI - #2117
• Fixed: Virtual screen rotation is not disabled in the app menu if the virtual screen is associated to a display and is set to auto-follow display rotation - #2118
• Fixed: Associated virtual screen should not allow both enforcing mirror and auto-starting stream as this creates confusion - #2119

v2.0.6

• Fixed: App crashes when Settings is opened the first time on Monterey (2.0.5) - #2086
• Fixed: PIP and Streaming shows black blank screen on Monterey (ScreenCaptureKit issue) with 2.0.x - #2088
• Fixed: Header switches do not work in Monterey (header opens/closes instead) in v2.0.5 - #2089
• Fixed: Unapplied system configuration loop when custom resolution added - #2084
• Fixed: Header switches do not properly revert if the operation is cancelled in the warning dialog box in v2.0.5 - #2090
• Fixed: Stream submenu is a few pixels wider than optimal pushing the menu boundaries in v2.0.5 - #2091
• Fixed: Disconnected display still has an (empty) Image Adjustments menu on Intel - #2093

v2.0.5

• Improve PIP window location saving so it remembers display it was last located on - #2043
• PIP window should properly restore over menu bar area and keep custom aspect ratio relative to screen size - #2080
• Tweak the menu sizes just a little bit - #2063
• Add option to automatically close expandable menu item - #2066
• Add menu icon color to show active state of mirroring, rotation and config protection - #2067
• Add a light onboarding for first time users - #640
• Fixed: Missing hidden default-invalid HiDPI resolutions in v2.0.4 - #2082
• Fixed: Resolutions not available as HiDPI show up in Custom Resolutions list as "Currently available as HiDPI" - #2081
• Fixed: Keyboard shortcut for contrast control defaults to software contrast even when hardware contrast is available in v2.0.x ...

v2.0.10

About this version

This version contains fixes and various improvements and adds Portuguese (Brazil) and Romanian localizations.

Enhancements

• Added Portuguese (Brazil) localization (thanks to @gpnunes75)
• Added Romanian localization (thanks to @mikevic18)
• Added option to limit Apple and third party display hardware brightness control range for combined brightness control (this helps avoid PWM for those who are sensitive to it) - #1946
• Added option to customize sub-hardware-dimming and XDR/HDR upscale point for the display - #637
• Added standard menu with Edit submenu for Settings to allow general clipboard operations in text fields - #2188
• Show app menu dock icon while Settings is open + proper Command+TAB and Stage Manager support for the Settings window - #2167
• Improve handling default resolution on Intel Macs when system configuration editing and custom resolutions are enabled (requires re-running configuration edit) - #2200
• Auto-start PIP window when it is configured on app managed connect as well - #2187
• Auto-resume full-screen streaming - #1368
• Added "Redetect displays" option to the Tools menu - #2182
• Aggressive disconnect - option to auto-disconnect a display upon detection (or restore disconnect state upon app startup) - #1846
• Try to initiate screen recording permissions workflow in System Settings when virtual screen is configured for streaming and permission is missing - #2178
• Improved support for DisplayLink displays in v2.x (automatic handling of changing UUID issue for Apple Silicon) - #2148
• Added option to change default display identification method - #2179
• Added back mirror configuration option to virtual screen creation workflow (now only stream configuration is there) in v2.x - #2149
• Menu header of disconnected device should not respond to clicks (to silently open/close the menu) - #2196
• Added "Unknown Display" display type for unknown displays - #2203
• Auto-forget displays after a while with customizable number of days and different rememberance time for unknown Generic Displays - #2169
• Added information about a display's first connection, last connection and last unseen date in Display Information
• Added "Don't show again!" option to "The app is already running..." message on relaunch and go straight to opening the app menu - #2211
• Faster and more advanced display override on-the-fly activation for external displays - #2212
• Added option to re-initialize external displays (helps counter Sonoma custom display configuration bug) - #2204

Fixed

• External display custom system configuration does not load properly on Sonoma after display detection - #2218
• Virtual screen workflow creation alert texts not presented properly - #2177
• Some menu icons aren't centered when in LoDPI mode - #2195
• If the display header menu toggle is set to something other than connect/disconnect but connect/disconnect is supported, the relevant - menu option does not appear - #2197
• If the app menu is already open on a screen and the user clicks the menu bar button on an other display, the app menu closes instantly - after transported to the other screen - #2202
• App menu tends to go jump around endlessly when the current screen's orientation is changed - #2217

Localization status and credits

• Chinese, Simplified - 100% - @BingoKingo
• English - 100% (language of app development) - @waydabber
• German - 6% - @mickimnet, @philipbrembeck
• Japanese- 99% - @SakiPapa
• Portugese (Brazil) - 100% - @gpnunes75
• Romanian - 100% - @mikevic18

Note: you can change the app's language under System Settings > General > Language & Region > Applications.

Notes about upgrading to the v2.x version

• Existing v1.x installations will not auto-update to the v2.x version - if you want to switch to the new version (which is highly recommended), please download and install the v2.x version.
• The v2.x version requires macOS Sonoma, Ventura or the latest version of Monterey. For older macOS versions (Mojave and up) please use the v1.x version.
• Settings of the v1.x app version are not carried over or altered by the v2.x version - you can downgrade to the v1.x version safely any time if you encounter issues with the new v2.x version.

Change log of previous v2.0.x versions

v2.0.9

• Added general localization support to the app - #1343
• Added Chinese, Simplified localization - #2145
• Added Japanese localization thanks to - #2145
• Added toggle to turn Notch area on/off on Liquid Retina displays (MacBooks) - #2102
• Fixed: Custom app menu icon and "match menu icon with main display icon" does not apply upon app start (need to toggle the on/off switch) - #2133
• Fixed: Dividers look overemphasized on callout style submenus on Ventura - #2134
• Fixed various typos - #2138

v2.0.8

• Added option for a floating submenu style option instead of expanding submenu style - #2128
• Fixed: Improperly shaped keyboard ring appears in app menu and Settings when "Full Keyboard Access" accessibility is enabled - #2124
• Fixed: Detached app menu: with a transparency level of 100%, I would expect the detached menu to be opaque, and it is not - #2125
• Fixed: DDC Input configuration menu visibility dropdown issue - #2126
• Fixed: Virtual screen does not auto-connect when created as associated to a display but full-screen stream is not configured - #2131

v2.0.7

• Animations to PIP and full screen stream transormations - #2100
• Added warning about stream auto-start for associated display in Virtual Screen Stream menu - #2121
• Added warning about enforced mirror for associated display in Virtual Screen Mirror menu - #2120
• Fixed: Associated virtual screens should have a disabled disconnect toggle in the menu header instead of a live one (v2.0.6) - #2097
• Fixed: Flip and Rotate settings do not apply properly on Stream start (v2.0.6) - #2098
• Fixed: Empty Image Adjustments menu appears on a mirror target display with no colortable support - #2099
• Fixed: Animations to PIP and full screen stream transormations - #2100
• Fixed: Resolution slider setting changes do not take effect in the app menu instantly - #2103
• Fixed: Detachable app menu transparency level option should be disabled when the menu is not detachable - #2104
• Fixed: A favorite added using the Display Mode menu does not immediately appear on the Resolution Slider - #2105
• Fixed: Resolution selection/"Limit resolution slider and keyboard shortcut range" option does not immediately affect resolution slider - #2107
• Fixed: When invoking Settings UI from the menu, the menu does not always close (possibly covering Settings) when not detached - #2111
• Fixed: "Show slider markers only while dragging the knob" toggle works in reverse - #2114
• Fixed: When the app is already running and the menu is detached, starting the app again puts the menu into a mixed/invalid state - #2116
• Fixed: Some advanced association settings show up inverted in the Settings UI - #2117
• Fixed: Virtual screen rotation is not disabled in the app menu if the virtual screen is associated to a display and is set to auto-follow display rotation - #2118
• Fixed: Associated virtual screen should not allow both enforcing mirror and auto-starting stream as this creates confusion - #2119

v2.0.6

• Fixed: App crashes when Settings is opened the first time on Monterey (2.0.5) - #2086
• Fixed: PIP and Streaming shows black blank screen on Monterey (ScreenCaptureKit issue) with 2.0.x - #2088
• Fixed: Header switches do not work in Monterey (header opens/closes instead) in v2.0.5 - #2089
• Fixed: Unapplied system configuration loop when custom resolution added - #2084
• Fixed: Header switches do not properly revert if the operation is cancelled in the warning dialog box in v2.0.5 - #2090
• Fixed: Stream submenu is a few pixels wider than optimal pushing the menu boundaries in v2.0.5 - #2091
• Fixed: Disconnected display still has an (empty) Image Adjustments menu on Intel - #2093

v2.0.5

• Improve PIP window location saving so it remembers display it was last located on - #2043
• PIP window should properly restore over menu bar area and keep custom aspect ratio relative to screen size - #2080
• Tweak the menu sizes just a little bit - #2063
• Add option to automatically close expandable menu item - #2066
• Add menu icon color to show active state of mirroring, rotation and config protection - #2067
• Add a light onboarding for first time users - #640
• Fixed: Missing hidden default-invalid HiDPI resolutions in v2.0.4 - #2082
• Fixed: Resolutions not available as HiDPI show up in Custom Resolutions list as "Currently available as HiDPI" - #2081
• Fixed: Keyboard shortcut for contrast control defaults to software contrast even when hardware contrast is available in v2.0.x - #2059
• Fixed: Some sliders don't position the right-side value info properly on initial load in v2.0.4 - #2060
• Fixed: Changing a DDC control default level is not applied with slider snap until restart/reconfiguration in v2.x - #2065
• Fixed: In some instances the menu outer size does not properly accommodate the content in v2.0.4 - #2068
• Fixed: Notched display aspect ratio should not be marked as "Notch" when rotated - #2069
• Fixed: When rotation is protected, the app reverts its own rotatio...

v2.0.9

About this version

This version introduces full localization support for BetterDisplay. First supported languages are Chinese, Simplified (thanks to @brukaya) and Japanese (thanks to @SakiPapa). Additional localizations will be added in subsequent releases.

Note: if this version shows up as localized (based on your macOS language settings) but you got used to the English version and want to revert to it, you can do so any time by adding BetterDisplay under System Settings > General > Language & Region > Applications and selecting your preferred language for the app.

If you want BetterDisplay in your language and willing to contribute to the localization effort, hop over to the Localization forum at the app's Discord channel until more formal instructions will be laid out in a wiki entry.

Enhancements

• Added general localization support to the app - #1343
• Added Chinese, Simplified localization thanks to @brukaya - #2145
• Added Japanese localization thanks to @SakiPapa - #2145
• Added toggle to turn Notch area on/off on Liquid Retina displays (MacBooks) - #2102

Fixed

• Custom app menu icon and "match menu icon with main display icon" does not apply upon app start (need to toggle the on/off switch) - #2133
• Dividers look overemphasized on callout style submenus on Ventura - #2134
• Fixed various typos - #2138

Notes about upgrading to the v2.x version

• Existing v1.x installations will not auto-update to the v2.x version - if you want to switch to the new version (which is highly recommended), please download and install the v2.x version.
• The v2.x version requires macOS Sonoma, Ventura or the latest version of Monterey. For older macOS versions (Mojave and up) please use the v1.x version.
• Settings of the v1.x app version are not carried over or altered by the v2.x version - you can downgrade to the v1.x version safely any time if you encounter issues with the new v2.x version.
• The same license code works for the v1.x version and v2.x versions. If you purchase Pro in one version, you can activate and use the other as well.

Change log of previous v2.0.x versions

v2.0.8

• Added option for a floating submenu style option instead of expanding submenu style - #2128
• Fixed: Improperly shaped keyboard ring appears in app menu and Settings when "Full Keyboard Access" accessibility is enabled - #2124
• Fixed: Detached app menu: with a transparency level of 100%, I would expect the detached menu to be opaque, and it is not - #2125
• Fixed: DDC Input configuration menu visibility dropdown issue - #2126
• Fixed: Virtual screen does not auto-connect when created as associated to a display but full-screen stream is not configured - #2131

v2.0.7

• Animations to PIP and full screen stream transormations - #2100
• Added warning about stream auto-start for associated display in Virtual Screen Stream menu - #2121
• Added warning about enforced mirror for associated display in Virtual Screen Mirror menu - #2120
• Fixed: Associated virtual screens should have a disabled disconnect toggle in the menu header instead of a live one (v2.0.6) - #2097
• Fixed: Flip and Rotate settings do not apply properly on Stream start (v2.0.6) - #2098
• Fixed: Empty Image Adjustments menu appears on a mirror target display with no colortable support - #2099
• Fixed: Animations to PIP and full screen stream transormations - #2100
• Fixed: Resolution slider setting changes do not take effect in the app menu instantly - #2103
• Fixed: Detachable app menu transparency level option should be disabled when the menu is not detachable - #2104
• Fixed: A favorite added using the Display Mode menu does not immediately appear on the Resolution Slider - #2105
• Fixed: Resolution selection/"Limit resolution slider and keyboard shortcut range" option does not immediately affect resolution slider - #2107
• Fixed: When invoking Settings UI from the menu, the menu does not always close (possibly covering Settings) when not detached - #2111
• Fixed: "Show slider markers only while dragging the knob" toggle works in reverse - #2114
• Fixed: When the app is already running and the menu is detached, starting the app again puts the menu into a mixed/invalid state - #2116
• Fixed: Some advanced association settings show up inverted in the Settings UI - #2117
• Fixed: Virtual screen rotation is not disabled in the app menu if the virtual screen is associated to a display and is set to auto-follow display rotation - #2118
• Fixed: Associated virtual screen should not allow both enforcing mirror and auto-starting stream as this creates confusion - #2119

v2.0.6

• Fixed: App crashes when Settings is opened the first time on Monterey (2.0.5) - #2086
• Fixed: PIP and Streaming shows black blank screen on Monterey (ScreenCaptureKit issue) with 2.0.x - #2088
• Fixed: Header switches do not work in Monterey (header opens/closes instead) in v2.0.5 - #2089
• Fixed: Unapplied system configuration loop when custom resolution added - #2084
• Fixed: Header switches do not properly revert if the operation is cancelled in the warning dialog box in v2.0.5 - #2090
• Fixed: Stream submenu is a few pixels wider than optimal pushing the menu boundaries in v2.0.5 - #2091
• Fixed: Disconnected display still has an (empty) Image Adjustments menu on Intel - #2093

v2.0.5

• Improve PIP window location saving so it remembers display it was last located on - #2043
• PIP window should properly restore over menu bar area and keep custom aspect ratio relative to screen size - #2080
• Tweak the menu sizes just a little bit - #2063
• Add option to automatically close expandable menu item - #2066
• Add menu icon color to show active state of mirroring, rotation and config protection - #2067
• Add a light onboarding for first time users - #640
• Fixed: Missing hidden default-invalid HiDPI resolutions in v2.0.4 - #2082
• Fixed: Resolutions not available as HiDPI show up in Custom Resolutions list as "Currently available as HiDPI" - #2081
• Fixed: Keyboard shortcut for contrast control defaults to software contrast even when hardware contrast is available in v2.0.x - #2059
• Fixed: Some sliders don't position the right-side value info properly on initial load in v2.0.4 - #2060
• Fixed: Changing a DDC control default level is not applied with slider snap until restart/reconfiguration in v2.x - #2065
• Fixed: In some instances the menu outer size does not properly accommodate the content in v2.0.4 - #2068
• Fixed: Notched display aspect ratio should not be marked as "Notch" when rotated - #2069
• Fixed: When rotation is protected, the app reverts its own rotation change - #2070
• Fixed: The app menu annoyingly closes when opened on a screen with a Notch that has a full screen application running - #2072
• Fixed: When only a single display is shown and there is no header, the expanded menu item's header does not line up nicely with the top of the menu window - #2073
• Fixed: Incorrect/missing padding for some expanded menus in v2.0.4 - #2074

v2.0.4

• Full SwiftUI app menu rewrite - increased responsiveness and fluidity - #1880
• Prevent app menu from disappearing after selecting a feature - #2003
• Make app menu detachable (Pro) - #1777
• Self-contained app-menu layout (no external submenus) - #2009
• Add app menu transparency option for detached mode - #2008
• More intuitive Move Display feature - #2012
• Improve resolution selector menu - #1205
• Add a more obvious warning to the app menu to set up accessibility permissions - #2017
• Add DDC Input Configuration link to the DDC input submenu - #2016
• Various UI tweaks/visual improvements - #2018
• Update UI for Display Mode favorites - #2057
• Add various options to auto-manage/compact the app menu - #2021
• Add a small icon in the display header to indicate main status - #2030
• Show current rotation in the app menu as well (without opening) - #2050
• Show notched display icon for built-in displays (Sonoma) - #2045
• Generally improve responsiveness of screen streaming and PIP operations. - #2034
• Add indigo color to the appropriate icon when PIP and Streaming is active - #2052
• Update PIP and streaming to use ScreenCaptureKit - #1411
• Add hiding mouse cursor in PIP/Stream even when there is a virtual display connected - #1992
• Ability to alter configuration of currently disconnected displays - #935
• Add option to forget past connected displays - #1988
• Virtual screen + streaming setup should have a warning when streaming permissions are not given - #1993
• Move mouse over to stream source display only if it's already on the stream target display - #2033
• More ergonomic Stream and PIP menu - #2038
• Draw stream/PIP crop area on screen - #1342
• Add per-display advanced hardware identification options (UUID, basic, extended, location) - #2053
• Show virtual screen and real display connection status in Settings selector icon - #1983
• Show virtual screen internal identifier and display UUID in Settings - #1984
• Add an op...