Lunar Pro
Sync Mode
Synchronise the brightness of your built-in display to all your external monitors.
Supported sources
- MacBook display
- iMac display
- Apple monitors with integrated light sensor
- LG Ultrafine
- Pro Display XDR
- Useful if you use a Mac Mini or a MacBook with the lid closed
Description
If you have "Automatically adjust brightness" enabled in System Preferences, macOS will always adapt the internal display to the ambient light around you using its internal light sensor near the webcam.
Lunar can take advantage of that by continuously polling the MacBook display and sending every brightness change to the external monitors.
Brightness Observer
If the Polling Interval setting is set to 0 seconds
then Lunar will use an internal macOS notification system to observe brightness changes instead of continuosly polling the display.
This greatly reduces CPU usage when there's no brightness change.
Dynamic polling interval
If the Polling Interval is 1 second or more, Lunar polls the internal display for brightness changes in the following way:
- Every
x
seconds the display brightness is read and compared to the last value - If the brightness has changed, Lunar starts a fast polling process where the brightness is read every 100ms
- if no new brightness change has been detected in the last 3 seconds, Lunar switches back to the efficient polling interval of
x
seconds
The x
seconds interval is user configurable to any value greater or equal to 1 second.
Source displays
Lunar is not limited to syncing the brightness from the MacBook display. You can use any monitor as a source as long as it has a light sensor and supports Apple’s native brightness changing protocol.
Monitors that are known to match this criteria:
- LG Ultrafine
- Pro Display XDR
To use a monitor as a source, click on the Sync Target button on the display page to toggle it to Sync Source.
Brightness keys (and TouchBar)
Because Lunar is constantly listening for brightness changes, you may keep adjusting your source display using the brightness keys, TouchBar sliders or Control Center from the menu bar, and your external monitors will get those adjustments as well.
You can also adjust external monitors separately using Ctrl+Brightness Up/Down.
Curve algorithm for Sync Mode
When Lunar detects a brightness change, it doesn't send the brightness value of the internal display as it is. Instead the value is passed through an algorithm that is constantly adapting to your manual adjustments so that the perceived luminosity stays the same across all monitors.
This is needed because some monitors can look brighter than others with the same brightness value. For example the MacBook display has 500 nits of brightness which is very bright compared to other monitors, so 50% brightness on MacBook’s display may look noticeably brighter than 50% on your external monitors (which usually have around 300-400 nits).
The curve algorithm can be manually adjusted using the Curve Slope sliders inside the Controls menu.
Lunar can also learn from your personal light perception and readjust the curve whenever you manually change the brightness of an external monitor so that, over time, the brightness computed by Lunar will get closer and closer to what you need.
Steps for keeping luminance in sync
- Reset the Algorithm curve on all displays
- Adjust the Curve Slope on the target (external) displays until they reach the same perceived luminance as the source (built-in) display
- Whenever a target display feels darker/brighter than it should be, use
Ctrl
+Brightness Up/Down
to adjust it until it's back in sync with the source- In multi-monitor setups you can move the cursor to that display and use
Shift
+Brightness Up/Down
to control it - You can also use the sliders to do this
- In multi-monitor setups you can move the cursor to that display and use
- Lunar will recompute the curve based on these manual adjustments so that it will be completely automatic after a few days
Location Mode
Adapt the brightness of your monitors based on the sun position in the sky.
If you use your monitors in a room with lots of natural light, Location Mode might be a good choice.
Location sources
Lunar will ask for Location Services permissions when you first launch it, and will fetch your last coordinates to compute the sun position throughout the day.
If Location Services permissions are not granted or if there are no valid coordinates, Lunar will try an IP Geolocation service like ipstack.com
If both methods fail, Location Mode will be unavailable as a choice.
Function
The way Location Mode works is pretty simple:
- When the sun is at its zenith (highest position in the sky, noon), Lunar will set all the monitors to their Max Brightness
- When the sun is below the horizon (between twilight and dusk), Lunar will set all the monitors to their Min Brightness
- Anything in between is passed through the Curve Algorithm to compute a fitting brightness for each monitor
Curve Algorithm for Location Mode
This is the algorithm that converts the sun position (in degrees relative to horizon) to a brightness value specific to each monitor.
The curve algorithm can be manually adjusted using the Curve Slope sliders inside the Controls menu.
Lunar can also learn from your personal light perception and readjust the curve whenever you manually change the brightness of an external monitor so that, over time, the brightness computed by Lunar will get closer and closer to what you need.
Sensor Mode
Use an external Ambient Light Sensor to adapt your monitors.
The light sensors integrated in the MacBook and iMac are the best around. But in some cases, an integrated light sensor is not available. Some of these cases include:
- Mac Mini
- MacBook with lid closed (clamshell mode)
- Hackintosh
- Mac Pro
Lunar can read the ambient light using an external sensor that can be either wireless or connected through USB.
The functioning principle is similar to Sync Mode: every 2 seconds the lux value of the ambient light is read from the sensor and passed through the Curve Algorithm to be computed into a fitting brightness for each monitor.
To read about how you can make your own ambient light sensor for Lunar, check this page: DIY Ambient Light Sensor
Curve Algorithm for Sensor Mode
This is the algorithm that converts the ambient light (in lux) to a brightness value specific to each monitor.
The curve algorithm can be manually adjusted using the Curve Slope sliders inside the Controls menu.
Lunar can also learn from your personal light perception and readjust the curve whenever you manually change the brightness of an external monitor so that, over time, the brightness computed by Lunar will get closer and closer to what you need.
Clock Mode
Adapt your monitor brightness and contrast based on a pre-defined schedule.
If you use your monitors in a shared office, or if you usually work on a well defined schedule, Clock Mode can be a good choice.
Schedule Types
Each schedule can be of the following types:
- Time: apply values at a specific time of day
- Sunrise: apply values when the sun starts to rise above the horizon
- Noon: apply values when the sun is at its highest point in the sky
- Sunset: apply values when the sun starts to fall below the horizon
Sunrise, sunset and noon
- The time for these types is computed daily
- The time can be offset using the hour/minute and sign values
- If the sign is
+
the values will be applied after the sunset time - If the sign is
-
the values will be applied before the sunset time
Schedule Transitions
- None: the brightness and contrast are applied at the exact time of the schedule
- 30 minutes: the brightness and contrast start transitioning 30 minutes before the schedule time, from your current brightness to the schedule brightness
- When the transition starts, the algorithm applies the computed values every 30 seconds so it doesn't allow for manual adjustments in the 30 minutes before the schedule
- Full: the brightness and contrast transition from schedule to schedule
- This transition applies the computed values every 30 seconds so it doesn't allow for manual adjustments
Events
The previous schedule values are re-applied when following events happen:
- Wake from sleep
- Display list changes (display connected/disconnected or enters standby)
- App is launched
To disable this event behaviour, uncheck Re-apply brightness on screen wake
in Advanced settings
Unlimited manual adjustments
The free version of Lunar allows you to control the monitor's brightness, contrast, volume and switch inputs, using either hotkeys, Media Keys, UI or through the command line integrations.
The only difference with Pro here is that brightness and contrast adjustments have a limit of 100 adjustments per day.
An adjustment is counted towards the limit only after you have finished fiddling with the brightness/contrast value.
For example, the following actions will only count as 1 single adjustment:
- Press the
Brightness Up
key 3 times to get from 5% to 25% - After 5 seconds you notice that the brightness is a bit too high and press
Brightness Down
one time to go to 20% - After another 5 seconds, you hover over the menu bar icon to open the
Quick Actions
menu and scroll tofine tune the Contrast
so that the whites aren't so jarring in your dark room - Finally, you press the
Brightness Up
key again as in lower contrast you need a bit more brightness for legible text
When you have done 100 adjustments in a day and the limit is reached, any new adjustment will show this dialog:
The Pro license lifts this limit and you can do as many adjustments as you want.
FaceLight
Light up your face in video calls.
How it works
FaceLight can turn your monitor into a really bright LED panel to light up your face when you're having video calls in a dark room.
The default hotkey for toggling FaceLight is Control+Command+5
. You can also activate FaceLight from the Lunar menu.
- Simply move your cursor on the monitor you want to use as the light and press the hotkey to activate FaceLight
- Lunar will increase the active monitor's brightness and contrast to maximum and place a warm-white overlay on top of your screen
- Press the hotkey again to deactivate FaceLight and return to the previous brightness
BlackOut
Selectively turn off displays without disconnecting them.
Use cases
- Turn off the MacBook display without closing the lid
- Turn off external monitors while keeping the USB and charging capabilities
- BlackOut all displays except one so you can focus on it
How it works
- Move your cursor on the screen that you want to turn off
- Press the
Control+Command+6
hotkey to activate BlackOut - Press the hotkey again to deactivate BlackOut and return to the previous brightness
The default hotkey for toggling BlackOut is Control+Command+6
.
You can also activate BlackOut from the Lunar menu or by pressing the ⏻ Power button in the Preferences window.
Modifiers
Hold the following keys while clicking the button (or while pressing the hotkey) to change BlackOut behaviour:
Shift
: make the screen black without mirroringOption
: turn off monitor completely using DDC (see caveats below)Option
+Shift
: BlackOut other monitors and keep the one with the cursor visible
The BlackOut hotkeys can be disabled from the Hotkeys page.
Caveats for DDC power off
- works only if the monitor can be controlled through DDC
- can't be used to power on the monitor
- when a monitor is turned off or in standby, it does not accept commands from a connected device
- remember to keep holding the Option key for 2 seconds after you pressed the button to account for possible DDC delays
Emergency Kill Switch: press the ⌘ Command
key more than 8 times in a row to force disable BlackOut.