Features

• Seamless XDR Brightness: enable XDR by simply increasing the brightness further after reaching 100%
• Allow disabling automatic Sub-zero Dimming and XDR Brightness from the Options menu

Improvements

• Make sure Auto Blackout works after screen wake by waiting for the system to settle the screen reconfiguration
• Restore XDR Brightness after screen wake
• Allow volume/mute hotkeys to work on the cursor display
• Move QuickActions options into a popover to lower height of the menu

Fixes

• Fix hiding the mute OSD

Improvements

• Don't apply app presets while XDR is enabled
• Lower CPU usage when checking for screenshot action on monitors that use Overlay

Features

• Disable Notch
  • Use hidden screen resolutions of the MacBook Pro to remove the notch completely

• Add option to disable "Control all monitors" for Function Hotkeys

Improvements

• The BlackOut Kill Switch doesn't trigger anymore on keys that contain more than just Command
• Increase precision of the self-learning algorithm
• Use astronomical sunrise/sunset as reference points in Location Mode
• Allow negative sun elevation in Location Mode

Fixes

• Fix crash when adjusting volume
• Fix crash when adjusting rotation
• Prompting about fallback to Software Dimming now makes sure the control is enabled
• Fix CLI printing displays
• Fix external display filter for CLI
• Fix brightness locking when interacting with brightness keys
• Fix flicker using the Brightness Slider because of Smooth Transition not being disabled while sliding

Features

• Custom Presets: save the current brightness/contrast as a preset that you can apply later

• Allow hiding most stuff in the QuickActions menu to get a smaller menu without unneeded functions

• Apply custom presets from the CLI:
  • lunar preset "Night Owl"
• Allow changing Min/Max Brightness on built-in and other non-DDC displays

Improvements

• The QuickActions menu now grows to the bottom instead of from the center to create a smoother feel
• Make sliders smoother by offloading adaptive mode work from the main thread when changing brightness fast
• Allow hiding Standard Presets from the Options menu
• Group resolutions by refresh rate
• Add images to differentiate resolutions easier
• Change some text fields to the system monospaced font because I like it
• Lower CPU usage overall by throttling events that happen too fast

Fixes

• Fix QuickActions menu appearing outside the screen edge
• Fix QuickActions menu redrawing at the center/bottom of the screen when changing specific settings

Features

• XDR Brightness: go past the 500 nits limit of the new 2021 MacBook Pro and Pro Display XDR
  • Warning: this is experimental. The system may become unresponsive for a few seconds when toggling this option
  • Animation glitches are expected when this is enabled

• Sub-zero dimming: dim brightness below 0%

• QuickActions redesign:

• Input Hotkeys redesign:

• Add BlackOut without mirroring checkbox in the Controls menu of each display
• Add BlackOut other displays action on holding Option+Shift
• Add Allow brightness to reach zero checkbox in the Controls menu for built-in displays
  • By default this is disabled to avoid turning off the display by mistake
• Implement BlackOut for AirPlay/Sidecar/DisplayLink (it's just a pitch black overlay really, but that's the most I can do)

Improvements

• Add Emergency Kill Switch for BlackOut
  • Press the ⌘ Command key more than 8 times in a row to force disable BlackOut
• F.lux detection improvements
  • Ensure Overlay gets activated
  • Add note about Shifty as an alternative
  • Update AppleScript for Monterey
• Allow Preferences window to be moved by its background
• Add selector for switching between System and Lunar adaptive brightness
• Disable overlay temporarily when taking a screenshot

Fixes

• Fix Gamma flashing bright from time to time
• Remove Software Dimming delay if it's the only control enabled
• Fix displays having low brightness after wake/reconnection
• Fix overflow crash in Clock Mode
• Fix BlackOut being stuck when using it without mirroring
• Fix contrast getting stuck to 0 when Lunar is restarted while BlackOut is on
• Check for vendor ID on BetterDummy screens

Note: Starting from v5.5.0 Lunar will require macOS 11.0+

Fixes

• Fix deadlock on screen wake/reconnection

Changed from 5.4.2

Features

• Efficient Sync Mode
  • A new internal system API is used to react to built-in display brightness changes instead of polling continuously for them
  • This lowers the CPU usage to 0.1% on average when no brightness change occurs
  • This new method can be disabled by setting the Sync Polling Interval to a value greater than 0 seconds
  • If brightness syncing stops working after the update, try setting the Polling Interval to 2 seconds

• Add lunar blackout command to CLI
• Add lunar gamma --restore-color-sync command for resetting to system default color settings

Improvements

• Update ddcutil-server for Raspberry Pi OS 64-bit
• Improve Lunar CLI help

Fixes

• Fix software dimming not going back to 100% after app restart on more recent macOS versions
• Fix BlackOut dialog appearing wrongly

Features

• Efficient Sync Mode
  • A new internal system API is used to react to built-in display brightness changes instead of polling continuously for them
  • This lowers the CPU usage to 0.1% on average when no brightness change occurs
  • This new method can be disabled by setting the Sync Polling Interval to a value greater than 0 seconds
  • If brightness syncing stops working after the update, try setting the Polling Interval to 2 seconds

• Add lunar blackout command to CLI
• Add lunar gamma --restore-color-sync command for resetting to system default color settings

Improvements

• Update ddcutil-server for Raspberry Pi OS 64-bit
• Improve Lunar CLI help

Fixes

• Fix software dimming not going back to 100% after app restart on more recent macOS versions
• Fix BlackOut dialog appearing wrongly

Fixes

• Fix sudden brightness changes because of brightness being read incorrectly on some monitors
• Delay when retrying sensor requests
• Fix radius value disappearing on editing

Changes from 5.4.0

Features

Client-server architecture for the Lunar CLI

The lunar command can now control the running Lunar app directly instead of spawning a new instance.

If the Lunar app is not running, the CLI will automatically use the old method of running the command directly.

New arguments:

• --remote forces the lunar command to never spawn a new instance and fail if there's no Lunar app already running
• --host configures the hostname where to send the command
  • This means you can now also control Lunar apps running on other Macs
• --key configures the API key for authenticating the lunar command against the Lunar app server
  • This is only needed when controlling Lunar instances running on other systems
• --new-instance forces the lunar command to always run the command locally and spawn a new instance even if there's a Lunar app already running

BlackOut improvements

Added BlackOut without mirroring on holding Shift.

• Added logic to automatically disable BlackOut when monitors are disconnected and the only remaining display is blacked out
• Configured mirroring as .appOnly so that the system doesn't remember the BlackOut mirroring state after Lunar is quit

Improvements

• Make the resolutions dropdown more useful with some formatting and pretty colors
  • 
• Add a way to easily toggle between Software Dimming and Hardware DDC
  • 
• Add a way to install Lunar CLI from the command-line
  • /Applications/Lunar.app/Contents/MacOS/Lunar install-cli
• Allow 2-byte values for DDC commands because some monitors support wider ranges (e.g. ASUS PG32U)

Features

Client-server architecture for the Lunar CLI

The lunar command can now control the running Lunar app directly instead of spawning a new instance.

If the Lunar app is not running, the CLI will automatically use the old method of running the command directly.

New arguments:

• --remote forces the lunar command to never spawn a new instance and fail if there's no Lunar app already running
• --host configures the hostname where to send the command
  • This means you can now also control Lunar apps running on other Macs
• --key configures the API key for authenticating the lunar command against the Lunar app server
  • This is only needed when controlling Lunar instances running on other systems
• --new-instance forces the lunar command to always run the command locally and spawn a new instance even if there's a Lunar app already running

BlackOut improvements

Added BlackOut without mirroring on holding Shift.

• Added logic to automatically disable BlackOut when monitors are disconnected and the only remaining display is blacked out
• Configured mirroring as .appOnly so that the system doesn't remember the BlackOut mirroring state after Lunar is quit

Improvements

• Make the resolutions dropdown more useful with some formatting and pretty colors
  • 
• Add a way to easily toggle between Software Dimming and Hardware DDC
  • 
• Add a way to install Lunar CLI from the command-line
  • /Applications/Lunar.app/Contents/MacOS/Lunar install-cli
• Allow 2-byte values for DDC commands because some monitors support wider ranges (e.g. ASUS PG32U)

Fixes

• Check chart entries bounds before updating

Improvements

• Move to edDSA key for signing updates

Fixes

• Don't send DDC/CI request for locked value

Fixes

• Use all EDID data to encode monitor IDs
  • this should allow Lunar to support multiple monitors of the same kind

Improvements

• Convert to Swift 5

Features

• Add diagnostic tools
  • You can now open Lunar menu and click on Open Lunar diagnosticsto send me Lunar logs
• Complete multi-monitor support

Fixes

• Use system generated UUID to store settings per display

Improvements

• Convert to DDC handling code to Swift
• Store min/max settings as soon as they are changed

Fixes

• Revert DDC to C implementation with added multi-monitor support
• Fix 2.4.0 regression where only some types of connectors worked

Features

• Add customizable location coordinates
• Move updates to new domain: lunar.fyi

Features

• Make the UI larger to allow for more info and settings
• Add more annotations on the brightness chart

Fixes

• Fix cases where the UUID can't be allocated

Fixes

• Fix another case where UUID can't be allocated
• Fix display name detection
• Allow new monitor data to overwrite cached db rows

Fixes

• Fix memory management of EDID data

Fixes

• Fix data store merge policy

Improvements

• Add help buttons with popovers for explaining settings and modes

Features

• Lunar is now notarized and signed with a certificate bought from your donations! Thanks everyone!
• Added a polling interval in the Sync mode to adjust how fast Lunar syncs the built-in display brightness

Fixes

• Fix Start at Loginfunctionality
• The available settings now change instantly when you change the mode
• Settings should save properly now
• Fix a few crashes in the C code for DDC (still a few to go, but new job, less time..)

Improvements

• Change help popovers font to something more legible
• Make help links clickable (somewhat)

Features

• Quick Actions popover when hovering over the menu item
• Add support for LG UltraFine displays
• Implement Clamshell Mode
• Keep Lunar in sync by reading the monitor's brightness and contrast periodically
• Remove all third party analytics and add a single request for counting unique users anonymously
  • This request sends a SHA256 hash of your device serial number to my server through a pubsub service
  • The serial number is impossible to deduce from the hash and the request is untraceable back to your device

Fixes

• Fix left and right hotkeys not being registered sometimes
• Patch Magnet to disable Input Monitoring request
• Fix preferences saving permission
• Fix dictionary access race condition in DDC code

Improvements

• Replace Fabric with Sentry for crash reporting because Fabric was acquired by Google
• Remove HotKey library and rely only on the Magnet framework
• Add sane defaults for brightness/contrast limits and offsets
• Improve speed and responsiveness by using concurrent tasks where possible

Fixes

• Fix system freeze caused by trying to read monitor brightness using DDC
• Fix Manual mode values not respecting limits

Improvements

• Show Quick Actions when changing brightness/contrast using hotkeys

Fixes

• Fix lid closed detection on iMacs and Mac Minis

Improvements

• Add more crash data to allow me to better diagnose issues remotely
• Make transitions smooth by default on UltraFine displays
• Read brightness periodically by default on UltraFine displays

Features

• Add option to disable Quick Actions popover

Features

• Show both connected and disconnected displays in Quick Actions

Fixes

• Fix all kinds of crashes

Improvements

• Move display and app exceptions from Core Data to User Defaults to avoid concurrency bugs

Features

• Add special support for Apple Thunderbolt Display
• Add option to manually enable brightness monitoring (only for the brave)

Fixes

• Filter out built-in and testing displays from saved data

Improvements

• Make an attempt to detect slow DDC implementations and skip reading in those cases

Features

• Add option to remove disconnected displays from the Quick Actions popover
• Better detection of builtin displays

Fixes

• Fix a memory corruption bug

Improvements

• Improve detection of slow DDC implementations

Fixes

• Minimize non-null assertions
• Fix Day Length calculation in Location mode
• Fix "end scrolling" detection

Improvements

• Clamshell mode detection toggle in menu

Features

• Add support for changing monitor volume and mute state
• Show native OSD when changing monitor brightness, contrast and volume
• Implement listeners for media keys
  • Lunar will ask for accessibility permissions to enable this functionality
  • Instructions:
    • Press keyboard brightness keys while the cursor is on an external monitor to change the brightness on that monitor
    • Press Control + keyboard brightness keys to adjust contrast
    • Press keyboard volume/mute keys while the audio output is set to the monitor audio device to adjust volume/mute
    • In multi-monitor setups, Lunar can't detect which monitor audio device is selected so it will change the volume of the display that the cursor is on
• Many thanks to Hongfeng Xu (@Mic238) for helping me with extensive testing on these features!

Improvements

• Detect non-responsive monitors and show that in the Quick Actions popover
• Automatic detection of GPU for adaptive DDC reply delay
  • This should minimize kernel panics and system freezes when reading values from the monitor
• Add special brightness implementation for LED Cinemamonitors

Fixes

• Fixed a typo that was preventing smooth transition to be disabled for contrast

Fixes

• Make active screen detection more reliable
• Only allow one thread at a time to use DDC to avoid race conditions
• Disable up/down value change hotkeys when Quick Actions disappear
• Embed all used Swift libraries to avoid crashes on some systems

Improvements

• Increase brightness/contrast/volume hotkey step to 6
• Allow fine-adjustment hotkeys:
  • Use Option + hotkey for hotkeys assigned from the Lunar hotkey page
  • Use Option + Shift + hotkey for media keys
• Open System Preferences for displays/sound when pressing Option + media key

Fixes

• Fix some memory corruption bugs by improving concurrency
• Properly hide/show the Non-responsive DDCmessage
• Fix diagnostics encryption key missing

Improvements

• Add reset on clickaction to the Non-responsive DDCmessage

Fixes

• Fix crash when there are displays with same UUID
• Fix crash on MediaKeyTap deinit

Improvements

• Add a way to extend brightness range up to 255 for monitors that support this

Fixes

• Fix Sync mode thread not running on some occasions

Improvements

• Disable Adaptive button in Manual mode

Fixes

• Hide buttons and labels properly when no display is connected
• Fix a ton of memory leaks
• Fix volume keys not being able to be disabled

Improvements

• Show Lunar version in the menu
• Hide rarely used menu items under an Advancedsubmenu item

Features

• Implement built-in brightness clipping limits for monitors with lower range of brightness/contrast
• Add a menu item to allow disabling volume key listener

Fixes

• Fix Location Permissions prompt not showing up on macOS Catalina

Improvements

• Add a bit more analytics data and route the requests through my own server
• Upload diagnostics to my own server instead of transfer.sh
• Reduce memory usage by manually deallocating unused views

Fixes

• Fix monitor volume restore
• Fix crashes because of using deallocated self

Improvements

• Make display name editable

Fixes

• Fix tooltip not closing when clicking on the display page

Improvements

• Detect scrolling direction so that scrolling up always increases value

Improvements

• Show built-in brightness in menu
• Update hotkey libraries
• Use Swift Package Manager for most of the frameworks
• Use LaunchAtLogin framework to fix start at login

Lunar 4 has been released!

Head over to the official websitefor more details.

Fixes

• Show window when menu bar icon is hidden and app is launched while already running
• Fix data race when ddcutil service is found on the network
• Fix setting brightness for Apple vendored displays
• Delay reset for mDNS browser when coming out of standby to avoid a recent CoreFoundation bug: CFRunLoopSource type mismatch, found CFSocket
• Check for Catalina or higher before trying to get display info dictionary

Improvements

• Added Sync Mode test inside diagnostics

Fixes

• Fix valid updates checking logic
• Show window when menu bar icon is hidden and app is launched while already running
• Fix data race when ddcutil service is found on the network
• Fix setting brightness for Apple vendored displays
• Delay reset for mDNS browser when coming out of standby to avoid a recent CoreFoundation bug: CFRunLoopSource type mismatch, found CFSocket
• Check for Catalina or higher before trying to get display info dictionary

Improvements

• Added Sync Mode test inside diagnostics

Fixes

• It seems Lunar needs macOS 10.15 or higher (even though Xcode compiles it just fine for 10.13) so I made that the minimum requirement

Improvements

• Added Advancedsetting for disabling brightness re-apply on screen wake
• Show Lunar window before showing Paddle licensing UI

Fixes

• I'm really sorry if you have been seing the Your period of free updates has expiredscreen. This should be fixed now in 4.0.4 and the next update shouldn't show that screen anymore

Improvements

• Add native support for old Apple Cinemaand Cinema HDdisplays
• Add Show Dock Iconoption under Advanced settings

Fixes

• Ensure window is shown when launching Lunar while menubar icon is hidden
• Fix crash on NetServiceBrowser reset
• Fix crash because of settings observer being deallocated too soon

Features

• Make it possible to set Pro Display XDR and LG UltraFine monitors as source for Sync Mode

Improvements

• Show tooltips with the reason why a specific Mode is disabled when hovering on it
• Allow controlling monitor with the cursor on it when Send Keys To All Monitorsis unchecked
• Add useful reset buttons in the gear icon menu
  • Reset Network Controlfor when the network controls aren't activated automatically because the system mDNS browser is stuck
  • Reset DDCfor when DDC is deemed unresponsive because the system has reported the monitor as active when it was in fact inactive

Fixes

• Fix crashes because of gamma locking
• More UI accesses moved to Main Thread
• Fix display name edit not saving
• Fix network controller reset on wake and display reconnect
• Fix QuickActions floating window disappearing too quickly

Fixes

• Fix crash because of launch at login empty list

Fixes

• Fix built-in display detection logic
• Fix media key handler

Improvements

• Use DisplayServices to read builtin brightness and fix the HDR issue

Fixes

• Show correct builtin brightness in Lunar menu

Fixes

• Fix changing modes would not stop/start the Sync/Location/Sensor listeners

Improvements

• Show why Sync/Location/Sensor modes are disabled when Lunar Pro is not active
• Add Join the communitymenu item

Fixes

• Fix curve factor going to 0.00on some systems

Improvements

• Improve DDC framebuffer detection logic by using the private CGSServiceForDisplayNumberAPI
• Add a way to enable verbose logging in Advanced settings
• Set DDC back to responsive if any read/write succeeds

Fixes

• Fix flicker because of switching to/from fullscreen apps
• Fix app not responding on startup because of blocking the main thread too early in the startup process

Fixes

• Make sure brightness/contrast is not changed automatically when it is marked as locked
• Make gamma operation highlighter async to avoid blocking the UI on rare occasions

Fixes

• Shake window when trying to input an invalid field value
• Revert all changes to a field when pressing escape
• Pressing tab inside a field will commit the value
• Show Lunar window on the screen where the cursor is
• Hide yellow dot on operation end

Features

• DDC support for M1 Macs(beta)
  • Only possible because of the great advice and example code from Zhuowei Zhangand the amazing work of Davide Guerriand Tao J
  • Mac Mini HDMI still not working: Mac Mini Github issue
• Add a way to set default gamma values when using Hardware/Native/Network controls

Improvements

• Add "Hide yellow dot" checkbox in Advanced settings
• Reset DDC write/read faults when a successful read is detected to avoid the incorrect marking of monitors as Non-reponsive DDC

Fixes

• Fix license not being activated without an app restart
• Fix Location Mode not fetching correct sunrise/sunset/noon when close to midnight
• Don't reset ColorSync settings and hopefully respect calibration profiles in Gamma mode
• Fix brightness flickering caused by Gamma controls kicking in faster than DDC/CoreDisplay/Network by adding a 5 second delay to the Gamma setter after:
  • App launch
  • System startup
  • Login
  • Wake from standby
  • Display connection/reconnection

Changes from 4.3.0

Features

• Allow negative offsets for app exceptions
• Add separate curve factors for brightness and contrast

Improvements

• Add a way to change the automatic check for updates interval in Advanced settings
• Isolate reset actions into a dropdown
• App exceptions logic rewrite
  • Now the offsets are only applied if the app has any visible window on an external monitor (in the past the offsets were applied on app launch/quit)
  • The offsets are also only applied to the monitor where the app is visible

Fixes

• Always reset adjustment limit within 24 hours
• Fix diagnostics message saying the monitor supports DDC when in fact it didn't support it

Improvements

• Disable Gamma by default in Hardware/Native/Network controls
• Add checkbox to enable Gamma in non-Software controls
• Improve Mac Mini HDMI port detection to allow USB-C-to-HDMI adapters to work with DDC on the USB-C port

Fixes

• Fix Boolean value handling in the CLI integration
• Fix Quick Actions popover contents disappearing on some occasions

Improvements

• Allow up to 3 input hotkeys per monitor
• Improve AVService detection to allow even more monitors to be controlled through DDC on M1 Macs
• Add configurable DDC Sleep Factor in Advanced Settings

Fixes

• Fix crashes because of thread unsafe settings cache
• Remove scrolling from Quick Actions popover to fix all the disappearing issues
• Fix name being set to "Unknown" in some cases
• Fix "License Verification failed after 5 days" appearing incorrectly
• Fix input hotkeys not working anymore after a while
• Fix input dropdown not being updated with latest selected input by hotkey

Features

• Support for DIY Wireless Ambient Light Sensor
  • Tutorial on how to create your own sensor is almost done
  • Please check this page periodically for updates: https://lunar.fyi/sensor

Improvements

• Update Paddle framework which fixes the creation of the file default.profrawon every run of the CLI
• Show current version under the Lunar logo in the main window

Fixes

• Fix crashes because of thread unsafe hotkeys cache
• Fix crash because of accessing a nil variable
• Fix brightness being set to max after sleep
• Fix hotkey not being unregistered when clearing it using the xbutton

Features

• Tutorial completed for DIY Wireless Ambient Light Sensor:https://lunar.fyi/sensor
• Add option to apply volume 0 on pressing mute in Advancedsettings
  • Some monitors don't accept the mute DDC control so this could be useful
• Curve factors separated by display and mode
  • The curve factors are now found in the gear icon menu and are stored on a per-monitor and per-mode basis
  • If you set some curve factors while Lunar is in Sync Mode and then change to Location Mode for example, there will be different curve factor values

Improvements

• Re-apply brightness and contrast when the display control changes

Fixes

• Correctly turn on/off the refresh values thread when checking/unchecking "Refresh values from monitor settings"
• Turn on Sync Mode correctly on Lunar launch

Fixes

• Fix Auto-learning Curvefor Locationand Sensormode
• Move some UI operations on the main thread to keep the window visually consistent
• Check for possible clamshell mode while Sync Mode is adapting to avoid setting brightness to 0 before the IsLidClosedflag has been set

Features

• lunar://URLs for easy access to specific parts of the UI
  • Settings page: lunar://settings
  • Advanced Settings page: lunar://advanced
  • Hotkey page: lunar://hotkeys
  • Display page: lunar://displays
  • Specific display page: lunar://displays/:number(e.g. lunar://displays/3for third display)

Fixes

• Fix Auto-learning for Location mode when the sun is below the horizon (negative degrees)
• Fix silent automatic updates

Improvements

• Make the main window interaction smoother by removing unnecessary chart rendering
• Make the paid updates message clearer when the free updates period expires

Features

• Add support for ESP8266 sensor boards
• Implement auto-gain and adaptive integration time for light sensors

Improvements

• Make firmware installer window appear faster by looking for serial devices in the background
• Highlight Advancedsettings button
• Add URL for opening the gear icon menu directly: lunar://display/settings

Fixes

• Fix support for Adafruit Metro ESP32 S2
• Fix some unexpected crashes
• Keep Lunar Pro active when license fails verification with Paddle for the first few times

Improvements

• Remove the need for a yellow dot in Gamma and Network control
• Add Show virtual displayscheckbox in Advanced settings
  • Turns out DisplayLink monitors show up as virtual and you need this checked if you want Lunar to see the monitor
• Fix Gamma (Software Controls)curve calculation being skewed in the 0% to 10% range
  • The zero point (no gamma changes) is now when BRIGHTNESS=100 and CONTRAST=75
  • Lightness change between brightness values should be more consistent with the human eye response to light

Fixes

• Don't check for updates on launch if Check for updates automaticallyis disabled in Advanced settings
• Fix some unexpected crashes
• Fix license being disabled erroneously on network problems

Improvements

• Add SPI as lib dependency for sensor firmware to avoid compilation errors in the future
• Improve Network Control monitor matching in multi-monitor cases
• Quit older instances if a user launches Lunar while it is already running
• Always show Network Control prompt on the main monitor
• Check if new value is different from old value when listening for settings changes to avoid duplicating events

Fixes

• Don't check for updates on launch to avoid annoying people who don't like updates as much as I do
• Fix typo which caused the monitor serial to be wrongly compared to the product ID when matching monitors
• Allow CLI to set properties that don't need an available control

Features

• Dark Mode UI
  • 
• Add Built-in Display page
  • 
• BlackOut: a feature that lets you selectively turn off displays by:
  • Mirroring the main display contents
  • Setting their brightness and contrast to 0
  • How to use:
    • Press Ctrl+Cmd+6 to activate it and turn off the display where the cursor is
    • You can also activate it by clicking the power button on the display page for the following cases:
      • Built-in display
      • External monitors that don't support DDC
  • 
• Add "Use Alternate Brightness Keys" checkbox on the Hotkeys page
  • Useful if you have a keyboard that has F14/F15 keys and the Brightness keys can send special key codes
• Add "Include Built-in Display" checkbox on the Hotkeys page
  • Useful if you use a Hackintosh with an external monitor set as a built-in display
• Add Lock Curve button for disabling the auto-learning curve algorithm when needed
• Add Reset buttons in the gear icon menu
• Allow setting minimum values for DDC Limits
• Add more useful controls in the gear icon menu
  • DDC Color Gain
  • Resolutions (including hidden resolutions)
  • Screen orientation
  • 
  • 
• Replace the Adaptive button with a more useful input switch dropdown in the QuickActions menu
  • 

Improvements

• Respect custom color profiles when adjusting brightness using Gamma
• Handle non-english locales in text fields
• Show error when CLI can't be installed and show a possible fix using chown and chmod
• Allow fuzzy display name matching in CLI
  • Things like this should work now:
    • Switch input to HDMI for LG UltraFine: lunar displays ultrafine input hdmi
    • Read contrast of Dell U3419W: lunar displays dell34 contrast
• Switch to rounding the curve value in the auto-learning algorithm for more precise mappings
• Make transitions smoother on Apple displays

Fixes

• Fix crash on Monterey beta 5 because of Thread.private not existing anymore
• Handle cases where app exceptions can't be added because their bundle doesn't contain CFBundleName
• Pin TSL2591 library to a known working version
• Fix DDC limits not being applied correctly in Manual Mode
• Fix data race crash when iterating some dictionaries
• Allow brightness 0 in Sync Mode on iMacs

Hotfix Release

Fixes

• Fix stack overflow crash in detecting if a display is built-in
• Check for display ID to be online before reading Gamma
• Make ColorSync profile matching in Software Control mode M1 only
  • This is because Apple's CGGetDisplayTransferByTable is buggy on Intel and crashes the app on some systems

Release Notes from 4.8.0

Features

• Dark Mode UI
  • 
• Add Built-in Display page
  • 
• BlackOut: a feature that lets you selectively turn off displays by:
  • Mirroring the main display contents
  • Setting their brightness and contrast to 0
  • How to use:
    • Press Ctrl+Cmd+6 to activate it and turn off the display where the cursor is
    • You can also activate it by clicking the power button on the display page for the following cases:
      • Built-in display
      • External monitors that don't support DDC
  • 
• Add "Use Alternate Brightness Keys" checkbox on the Hotkeys page
  • Useful if you have a keyboard that has F14/F15 keys and the Brightness keys can send special key codes
• Add "Include Built-in Display" checkbox on the Hotkeys page
  • Useful if you use a Hackintosh with an external monitor set as a built-in display
• Add Lock Curve button for disabling the auto-learning curve algorithm when needed
• Add Reset buttons in the gear icon menu
• Allow setting minimum values for DDC Limits
• Add more useful controls in the gear icon menu
  • DDC Color Gain
  • Resolutions (including hidden resolutions)
  • Screen orientation
  • 
  • 
• Replace the Adaptive button with a more useful input switch dropdown in the QuickActions menu
  • 

Improvements

• Respect custom color profiles when adjusting brightness using Gamma
• Handle non-english locales in text fields
• Show error when CLI can't be installed and show a possible fix using chown and chmod
• Allow fuzzy display name matching in CLI
  • Things like this should work now:
    • Switch input to HDMI for LG UltraFine: lunar displays ultrafine input hdmi
    • Read contrast of Dell U3419W: lunar displays dell34 contrast
• Switch to rounding the curve value in the auto-learning algorithm for more precise mappings
• Make transitions smoother on Apple displays

Fixes

• Fix crash on Monterey beta 5 because of Thread.private not existing anymore
• Handle cases where app exceptions can't be added because their bundle doesn't contain CFBundleName
• Pin TSL2591 library to a known working version
• Fix DDC limits not being applied correctly in Manual Mode
• Fix data race crash when iterating some dictionaries
• Allow brightness 0 in Sync Mode on iMacs

Hotfix Release

Fixes

• Make Gamma ColorSync profile matching work on Intel as well
  • Many thanks to @waydabber for suggesting that a Gamma table of 256 values might fix this
• Fix Hotkeys handling after adding the built-in display page
• Add missing hotkeys for changing screen orientation in Advanced settings
• Fix recursive locking crash because of using NSScreen inside MPDisplay

Release Notes from 4.8.0

Features

• Dark Mode UI
  • 
• Add Built-in Display page
  • 
• BlackOut: a feature that lets you selectively turn off displays by:
  • Mirroring the main display contents
  • Setting their brightness and contrast to 0
  • How to use:
    • Press Ctrl+Cmd+6 to activate it and turn off the display where the cursor is
    • You can also activate it by clicking the power button on the display page for the following cases:
      • Built-in display
      • External monitors that don't support DDC
  • 
• Add "Use Alternate Brightness Keys" checkbox on the Hotkeys page
  • Useful if you have a keyboard that has F14/F15 keys and the Brightness keys can send special key codes
• Add "Include Built-in Display" checkbox on the Hotkeys page
  • Useful if you use a Hackintosh with an external monitor set as a built-in display
• Add Lock Curve button for disabling the auto-learning curve algorithm when needed
• Add Reset buttons in the gear icon menu
• Allow setting minimum values for DDC Limits
• Add more useful controls in the gear icon menu
  • DDC Color Gain
  • Resolutions (including hidden resolutions)
  • Screen orientation
  • 
  • 
• Replace the Adaptive button with a more useful input switch dropdown in the QuickActions menu
  • 

Improvements

• Respect custom color profiles when adjusting brightness using Gamma
• Handle non-english locales in text fields
• Show error when CLI can't be installed and show a possible fix using chown and chmod
• Allow fuzzy display name matching in CLI
  • Things like this should work now:
    • Switch input to HDMI for LG UltraFine: lunar displays ultrafine input hdmi
    • Read contrast of Dell U3419W: lunar displays dell34 contrast
• Switch to rounding the curve value in the auto-learning algorithm for more precise mappings
• Make transitions smoother on Apple displays

Fixes

• Fix crash on Monterey beta 5 because of Thread.private not existing anymore
• Handle cases where app exceptions can't be added because their bundle doesn't contain CFBundleName
• Pin TSL2591 library to a known working version
• Fix DDC limits not being applied correctly in Manual Mode
• Fix data race crash when iterating some dictionaries
• Allow brightness 0 in Sync Mode on iMacs

Fixes

• Fix DDC for monitors that act as TVs when in fact they aren't

Improvements

• Add contact form on lunar.fyi
• Allow fully offline installations

Features

• Add navigation bar and remove left/right arrow buttons
• Simplify and smoothen brightness graph
  • More complex data can be shown by enabling Show more graph data in Advanced settings

Fixes

• Fix internal display being dimmed accidentally after the lid was opened
• Fix QuickActions popover closing accidentally right after opening

Improvements

• Add Continue button for diagnostics instead of relying on pressing keyboard keys
• Improve Native Controls detection for the built-in display when closing/opening the lid

Fixes

• Fix BlackOut hotkey not reflecting in the menu bar item
• Fix Check for Updates not working on some occasions

Features

• Add a way to hide the macOS volume OSD for monitors that have their own volume indicator
  • 

Features

• Revamped Hotkeys page for easier configuration of how the keys should work
• Hotkeys now support press and hold for repeating actions
• Add configurable FaceLight brightness/contrast settings inside the Lunar Display settings
• Add Disable all hotkeys button on the Hotkey page
  • 
• Add Slow brightness transition option
• Change Lunar window pages using keys:
  • Press H for the Hotkeys page
  • Press C for the Configuration page
  • Press B for the Built-in display page
  • Press 1..9 for switching to the Display page with that number

Improvements

• Re-apply BlackOut on screen wake to account for brightness being set to a non-zero value by the system
  • This needs Re-apply brightness on screen wake to be enabled inside Advanced settings
• Make the Gamma smooth transition dot even less visible to avoid creating the perception of a dust speck on the screen

Fixes

• Fix Lunar not responding in some cases when waking up from sleep
• Fix swipe being blocked on the Configuration page

Fixes

• Fix crash because of gamma smooth transition logic
• Fix crash when Sensor Mode would update brightness on a non-main thread
• Avoid app entering a not responding state when in Location mode and waking the screen

Improvements

• Make sure Gamma never goes below 0.08 on brightness 0 to retain visibility
• Allow press-and-hold detection to be disabled for users that encounter problems with it
• Remove unused serial-port and volume-based sensor options

Features

• Clock Mode: schedule brightness and contrast presets based on sunset/sunrise/noon or a specific time
• Dark Overlay dimming for displays that don't support Gamma or DDC (DisplayLink and Sidecar usually)
• Curve Learning now works with external brightness changes if Refresh values from monitor settings is enabled in Advanced settings
  • Contrast does nothing when the overlay is used
• Sensor Mode can now use the internal light sensor of the M1 MacBooks
• Add option to disable checking for DDC responsiveness in Advanced settings
• Display filters for deciding what to show in the Preferences window:
  • Virtual displays
  • AirPlay displays
  • Projectors
  • Disconnected monitors

Improvements

• Improve dynamic gain on the TSL2591 external light sensor by checking for overflows
  • You will need to reinstall the ambient light sensor firmware to get this improvement
• Improve Gamma smooth transitions by removing unnecessary animations and allowing it to appear on Mission Control
  • Thanks to @waydabber for finding out this edge case and for suggesting that the window needs to be set as stationary to fix it
• Recover Facelight state after screen sleep/wake
• Improve smooth and slow transitions for Apple vendored displays that can use Native Controls
• Reset audio device cache on wake and on display reconnection to avoid volume controls not working in some cases
• Do network requests asynchronously where possible to improve responsiveness and fix some memory leaks
• Simplify menu bar icon menu

Fixes

• Fix crash when the DDC faults storage was accessed from multiple threads
• Fix crash that happened on modifying the I2C controller cache when the IO registry tree changed

Features

• Useful Info menu item in menu bar that can also be hidden
• Allow BlackOut on single screen advanced setting for people that:
  • mostly use BlackOut from the keyboard
  • have the need to turn off the external monitor while the MacBook is in clamshell mode
• Option to show brightness and contrast of the active display beside the menu bar icon
• Option to hide the orientation switcher in the QuickActions menu
• Hide QuickActions when clicking anywhere outside of it

Improvements

• Change Apply Gamma checkbox to an enable/disable button that also disables value editing
• Close Quick Actions menu faster when moving the cursor away from it
• Better possible clamshell mode detection to avoid setting external monitor brightness to 0 when closing the MacBook lid

Fixes

• Fix crashes that happened because of accessing AVService/I2C cache from multiple threads
• Make sure to update some text fields that were not updated on launch

Features

• Support for M1 Pro and M1 Max
• Onboarding process on first launch
• Redesigned Diagnostics

• Redesigned Quick Actions menu
  • The menu appears on click instead of hover over the menu bar icon now
  • The native menu can be shown using:
    • Right click (or two finger Trackpad click) on the menu bar icon
    • Click on the three dots icon in the top right of the Quick Actions menu

• Sliders everywhere
  • Merged brightness and contrast slider
  • Volume slider in the QuickActions menu
  • Only possible with the incredible help of @waydabber, maker of BetterDummy
• Redesigned Display Settings menus

• Restart Lunar menu item and hotkey

• Overlay/Gamma switcher button inside the Controls menu

• App presets now work for the built-in display as well

• Adding Option key to the BlackOut hotkey will turn off monitor completely through DDC
  • Example: let's say you have configured BlackOut to activate on Ctrl-Command-6
  • Then pressing Ctrl-Command-Option-6 will allow you to turn off the monitor completely (just like pressing its physical power button) if the monitor supports that function
• Rounded corners for any display

Improvements

• Enable the power button in the Lunar window to also work when the Allow BlackOut on single screen option is enabled
• Add high memory usage checker to aid in fixing memory errors in the future
• Use Apple Native smooth transitions using private macOS APIs on Apple vendored displays
• Smooth transitions can now happen in parallel if there are multiple displays with different controls
• Cut the memory usage in half by replacing large images in the UI with vector-drawn bezier paths
• Improved BlackOut logic when using a dummy display
• Filter checkbox for showing/hiding dummy displays
• Hotkeys changing the display with the cursor now affect all monitors in a mirror set
  • This improves support for apps like BetterDummy

Fixes

• Software overlay for Sidecar now appears correctly on first connection
• Notify the system when changing built-in brightness to allow the system curve to readapt

Fixes

• Fix crash in diagnostics/onboarding when closing the window
• Automatically restart app when memory usage goes above 1GB
• The Advanced button on the Configuration page was not clickable on the top part

Fixes

• Fix lag and wrong monitor assignment when DDC was used for two identical monitors
• Fix crash when getting current resolution for some displays
• Fix Sync Mode for Ultrafines that report having ambient light adaptive brightness enabled when in fact they don't

Improvements

• Add all MCCS VCP codes to lunar ddc
• Add Use current brightness button in Clock Mode
• Add Merge brightness and contrast checkbox on the Configuration page
  • Allows for reverting to the previous behaviour of controlling brightness and contrast separately

Features

• Add Volume Slider show/hide toggle inside the DDC menu of external displays
• Add Copy from display for Curve Factors
• Add possibility to show slider values
• Separate brightness and contrast for app presets when Merge brightness and contrast is disabled
• Add Jitter After Wake function for monitors that wake up with dimmed brightness
  • Can be activated from the terminal using defaults write fyi.lunar.Lunar jitterAfterWake 1

Improvements

• Make contrast syncing snappier
• Make the CLI DDC values a bit smarter
  • If the value is in the form of 0x1F, x1F or 1Fh it is parsed as hex
  • Otherwise it is parsed as decimal
  • Passing --hex will always parse values as hex
• Work around the system issue where the built-in display brightness is reverting automatically after a manual change

It seems that some MacBooks don't support brightness change event notifications which causes the manual adjustments to not be reflected in the system brightnesss curve.In this update we try to detect if a MacBook is missing that support and instead of controlling its brightness, we forward the brightness key events to the system and let it do the brightness changing.Using the sliders for changing the built-in brightness will still have the reverting problem though, because we can't forward those events to the system.

Fixes

• Don't ask for permissions on every launch if the user doesn't need that functionality
• Don't force focus Lunar window if dark mode is toggled

Fixes

• Fix issue where adjusting brightness with keys would double the change for external displays

Fixes

• Fix detection for Samsung U28E850

Features

• Add back the Adaptive Mode dropdown in the QuickActions menu
• Add more useful buttons at the bottom of the QuickActions menu:
  • Preferences
  • Restart
  • Quit

Improvements

• Add menu item to Relaunch the onboarding process
• Improve QuickActions menu height formula
• Add notice about how to relaunch onboarding if needed
• Improve brightness slider for built-in display

Fixes

• Fix Sync Source button text being unreadable
• Fix overlay artifacts appearing when disconnecting iPad Sidecar
• Fix brightness OSD not showing in some cases
• Fix Clock Mode schedules being reverted to the current brightness on some occasions
• Fix App Presets window detection by intersecting the window frame with the raw display bounds

Improvements

• Correctly set max DDC brightness to 255 on LED Cinema displays

Fixes

• Fix clamshell mode detection for some special setups
• Fix brightness OSD not showing in some cases (missed some stuff)
• Fix brightness keys not working in previous release

Features

• Add possibility to stream logs to the developer in real time for more efficient troubleshooting

Improvements

• Make Gamma/Overlay changes faster when using sliders
• Make the Adaptive Mode dropdown easier to click
• Add note about how to adjust contrast independently on the Hotkeys page
• Make App Presets more reliable on single monitor setups by not caring about the window visibility
• Make Ultrafine AmbientLightCompensation detection more strict
  • It seems there are some models that report that AmbientLightCompensation is enabled while HasAmbientLightCompensation is false

Fixes

• Fix contrast media keys
• Fix internal sensor detection
• Fix contrast locking by itself when showing/hiding advanced settings

Improvements

• Make brightness key forwarding optional in Advanced settings
  • If the built-in display brightness is not persisting properly, try enabling this setting

Fixes

• Reset BlackOut state if brightness is greater than 1
• Don't show OSD for built-in brightness when forwarding media keys to the system
• Fix crash because of wrong datapoints for the Location Mode chart
• Fix Input Hotkey dropdown in Dark Mode

Note: if you have a monitor connected to the HDMI port of the 2021 MacBook, disable DDC manually for that monitor

Improvements

• Add an IOService event detector to re-create the I2C service port cache when the IOKit tree changes
  • This should help with cases when the monitor is not responding to Lunar's brightness/volume/input changes until app restart

Fixes

• Fix fetching script dir in Lunar sensor install script
• Remove HDMI port detection logic for M1 Pro/Max because it causes false positives
  • Will resume work on this when my MacBook arrives

Note: if you have a monitor connected to the HDMI port of the 2021 MacBook, disable DDC manually for that monitor

Fixes

• Make sure that monitors with Network Control disabled don't get matched with a Pi controller
• Remove the Lunar Test flashing text properly after onboarding

Improvements

• Show slider values on the knob
• Improve slider contrast
• Add glass material to QuickActions
• Detect HDMI port properly on the M1 Pro and M1 Max
  • This will disable DDC automatically for that port as there's still no way to send DDC commands through it

Fixes

• Hide second background of QuickActions when Reduce Transparency is active
• Make sure to re-enable adaptive brightness on built-in after switching from Manual to other modes while in an App Preset

Improvements

• Add a way to extend the range of Color Gain for professional displays like the Wacom Cintiq Pro
• Add a way to disable re-apply on wake for Color Gain
• Security updates to dependencies

Fixes

• Fix colors being washed out because the Color Gain value of the monitor didn't match what Lunar had stored

Improvements

• Move the Auto Blackout setting to the main preferences screen

Fixes

• Fix crash caused by SimplyCoreAudio deadlock

Improvements

• Move the Volume keys control all monitors setting to make its effect clearer

Fixes

• Fix crash caused by reading built-in brightness on a different thread
• Add 1 second delay between switching input and applying defined brightness on Input Hotkeys

Fixes

• Fix BlackOut getting stuck in some rare cases
• Release leaking memory on Intel DDC implementation with AMD GPU