Lunar
Adaptive brightness for external displays
Install with Homebrew
brew install --cask lunar
Lunar — Official Website
Quick Take: Lunar
Lunar fills a gap Apple has ignored for years: controlling external monitor brightness from your Mac. The free tier already delivers keyboard DDC control, sub-zero dimming, CLI and multi-monitor basics, with daily Manual and Shortcuts caps. Lunar Pro's Sync Mode and related adaptive features make an external monitor feel like a native Mac display and the $23 lifetime price with a 14-day trial remains fair for a daily-driver utility. Active 2026 maintenance through v6.10.4 (Shortcuts SDK rebuild, energy impact, Sync wake, OSD fixes) keeps it trustworthy on Tahoe. The main friction is still DDC compatibility through some docks, when hardware DDC fails, gamma fallback helps and pairing with BetterDisplay covers HiDPI needs Lunar doesn't chase.
Best For
- •Anyone with an external monitor who's tired of using physical monitor buttons
- •Night owls who need sub-zero dimming for dark environments
- •Multi-monitor users who want synchronized brightness
- •MacBook users who want Sync Mode adaptive brightness on external displays
- •Users who already run BetterDisplay and need a dedicated brightness automation layer
What is Lunar?
Lunar is a display brightness and contrast controller for macOS that solves a problem Apple has ignored for years: you can't natively adjust the brightness of external monitors using your Mac's keyboard. Apple's brightness keys only control the built-in display. If you have an external monitor, Dell, LG, BenQ, ASUS, Samsung, whatever, you're stuck reaching for the monitor's physical buttons, navigating through OSD menus and doing this every time the room lighting changes. Lunar fixes this by communicating with your monitor using DDC/CI (Display Data Channel Command Interface), a protocol that lets your Mac send brightness, contrast and volume commands directly to the monitor's firmware. Press your Mac's brightness keys and Lunar adjusts both your built-in and external displays simultaneously. The brightness slider in Control Center works for external monitors too. It feels like the monitor is natively integrated into macOS, which is exactly how it should work. Beyond basic brightness control, Lunar offers adaptive brightness modes (Sync, Location, Sensor and Clock), schedule-based brightness curves, per-app brightness presets, FaceLight, BlackOut and fine-grained color controls. The free tier includes DDC control, sub-zero dimming (software overlay below the hardware backlight minimum), brightness and volume keys, a CLI, input switching and multi-monitor support, with Manual Mode capped at 100 adjustments per day and Shortcuts limited to 100 actions per day. Lunar Pro ($23 lifetime, 14-day trial) unlocks unlimited adjustments plus Sync/Location/Sensor/Clock modes, App Presets, XDR Brightness, FaceLight and BlackOut. Lunar is developed by Alin Panaitiu and remains actively maintained, latest release v6.10.4 (2026-05-25). It requires macOS 11 or newer, ships native Apple Silicon and Intel builds and runs on macOS Tahoe 26.x. For anyone with an external monitor, which is most developers, designers and professionals, Lunar is the kind of utility that makes you wonder how you lived without it.
Deep dive: How DDC/CI Works and Why Apple Doesn't Support It
DDC/CI (Display Data Channel Command Interface) is a standard that's been around since the 1990s. It allows a computer to send commands to a monitor over the same cable that carries the video signal.
History & Background
DDC was originally designed for monitors to report their capabilities (resolution, refresh rate) to the computer. DDC/CI extended this to allow the computer to send commands back, adjusting brightness, contrast, volume and input source. Windows has supported DDC/CI natively for years. Apple has never implemented native DDC/CI control for third-party monitors on macOS, likely because Apple prefers its own displays with proprietary control protocols. That gap created the market for Lunar, MonitorControl, DisplayBuddy and related tools.
How It Works
Lunar reads DDC/CI capabilities from connected monitors and maps macOS brightness controls to DDC/CI commands. On Apple Silicon Macs, DDC/CI communication goes through the GPU's I2C interface. DisplayPort and HDMI usually carry DDC/CI reliably; some USB-C docks strip or corrupt the channel. Lunar includes gamma/software fallbacks for common failure modes, but hardware incompatibility remains the primary support issue, exactly why dock troubleshooting dominates community threads.
Ecosystem & Integrations
Lunar sits beside MonitorControl (free basic DDC), DisplayBuddy (polished paid DDC UI), BetterDisplay (HiDPI/resolutions) and Apple's built-in Displays settings (Apple hardware only). Community practice in 2026 often pairs Lunar with BetterDisplay rather than choosing one: Lunar owns adaptive brightness; BetterDisplay owns scaling.
Future Development
Recent changelog activity shows compatibility and polish: macOS 26.x SDK/Shortcuts work, M5 and MacBook Neo support, XDR sync fixes, energy impact, Sync Mode wake behavior and OSD fixes through v6.10.4. Expect continued monitor/connection compatibility and adaptive-mode reliability rather than a pivot away from brightness automation.
Key Features
DDC/CI Control
Lunar sends DDC/CI commands over DisplayPort or HDMI to control your monitor's brightness, contrast and volume at the hardware level. This means the monitor's own backlight adjusts, not a software overlay. The result is identical to pressing the buttons on the monitor itself, but controlled from your Mac's keyboard or menu bar. DDC/CI works with most external monitors from Dell, LG, BenQ, ASUS, Samsung, HP and others. Some monitors (particularly USB-C-only ones or those with limited firmware) don't support DDC/CI, in which case Lunar falls back to gamma/software brightness control.
Adaptive Brightness (Sync Mode)
When you have a MacBook with an ambient light sensor, Lunar Pro's Sync Mode can match your external monitor's brightness to your laptop's. As the room gets darker, your MacBook dims its built-in display and Lunar dims your external display proportionally. As sunlight hits your desk, both brighten together. This is automatic: Lunar reads the built-in display's brightness and maps it to DDC/CI values for your external monitor. You can adjust the mapping curve if the automatic behavior is too aggressive or too subtle. Community consensus treats Sync Mode as the main reason to buy Pro.
Sub-Zero Dimming
Most monitors can't go below about 20% brightness via DDC/CI, the backlight has a hardware minimum. Lunar's free tier includes sub-zero dimming by applying a dark overlay on top of the display output, letting you reduce effective brightness below the hardware minimum. This is a lifesaver for working in dark environments or at night when even the lowest monitor brightness is uncomfortably bright. It's a software trick, so contrast is reduced, but it's better than squinting.
Per-App Brightness Presets
Lunar Pro can automatically change brightness when you switch between apps via App Presets. Set your code editor to 40% brightness and your browser to 60%. When you switch from VS Code to Chrome, Lunar adjusts the monitor brightness automatically. This sounds gimmicky but is genuinely useful: coding on a dark-themed editor is comfortable at low brightness, while reading documentation in a browser benefits from higher brightness.
Location, Sensor and Clock Modes
Beyond Sync Mode, Lunar Pro offers Location Mode (brightness based on sun position), Sensor Mode (external ambient light sensors such as Xiaomi Mijia) and Clock Mode (schedule-based brightness curves through the day). Clock Mode works independently of macOS Night Shift (which changes color temperature, not brightness). The schedule editor lets you define custom curves with multiple control points throughout the day.
XDR Brightness, FaceLight and BlackOut
Apple's Pro Display XDR and MacBook Pro Liquid Retina XDR screens support brightness above the standard 500 nits. macOS only enables this for HDR content by default. Lunar Pro can unlock XDR brightness for SDR content when you need daylight readability. FaceLight brightens the built-in display as a soft fill light for video calls. BlackOut can blank or dim displays for focus, presentations or sleep setups.
Keyboard Hotkeys and CLI
Lunar hooks into the macOS brightness keys (F1/F2) and extends them to external monitors. When you press the brightness key, Lunar adjusts the external monitor along with (or instead of) the built-in display. A CLI (`lunar set brightness 50`) and Shortcuts actions support scripting and automation, free Shortcut actions are limited to 100 per day.
Contrast, Volume and Input Switching
Beyond brightness, Lunar can adjust contrast and volume via DDC/CI on monitors that support it and switch input sources from the Mac. Volume control is useful for monitors with built-in speakers, adjust the monitor's speaker volume without touching the OSD. Contrast adjustment helps fine-tune readability for different content types.
Who Should Use Lunar?
1The Developer with an External Monitor
You have a 27-inch Dell or LG connected to your MacBook. Every morning, you reach behind the monitor to press tiny buttons and navigate the OSD to set brightness. Every evening, you do it again. With Lunar, you press F2 on your keyboard and the external display dims alongside your MacBook. The monitor brightness is always right because Sync Mode tracks the ambient light. You never touch the monitor buttons again.
2The Night Owl Developer
You code late at night in a dark room. Even your monitor's lowest brightness setting is too bright. Lunar's sub-zero dimming applies a dark overlay that takes the effective brightness below the hardware minimum. Combined with Night Shift for color temperature, your eyes stop straining during late sessions.
3The Multi-Monitor User
You have three monitors: a MacBook screen, a Dell and a BenQ. Each has different brightness ranges and responds differently to DDC/CI commands. Lunar normalizes them, one brightness slider controls all three and adaptive modes keep them in sync. You can also set independent brightness for each monitor if you prefer your side displays dimmer.
4The Presentation Giver
You're presenting in a bright conference room. Your monitor is at 40% brightness because that's where you left it yesterday evening. Instead of fumbling with monitor buttons in front of clients, you press F2 a few times and Lunar brings the external display to full brightness. After the meeting, Sync Mode gradually dims it back as the room lighting changes.
5The Photographer/Designer
Color accuracy matters for your work. You need consistent brightness across your monitors for color grading and design review. Lunar lets you set exact brightness values (not just relative adjustments) via DDC/CI. This ensures your monitors are calibrated to the same brightness level. Clock or Location Mode helps maintain this calibration through changing ambient conditions.
How to Install Lunar on Mac
Lunar is available via Homebrew or direct download from lunar.fyi. It supports macOS 11+, Apple Silicon and Intel, including Tahoe 26.x.
Install via Homebrew
Run brew install --cask lunar in Terminal. The app installs to /Applications. For the latest version (v6.10.4 as of 2026-05-25), you can also download directly from https://lunar.fyi/.
Launch and Grant Permissions
Open Lunar. It may request Accessibility permission for keyboard shortcut integration. Grant it in System Settings → Privacy & Security → Accessibility.
Verify DDC/CI Works
Open Lunar's preferences and check if your external monitor appears with DDC/CI status. If it shows DDC supported, hardware brightness control works. If DDC fails (common with some docks), Lunar can fall back to gamma/software dimming.
Configure Sync Mode (Pro)
If you have a MacBook with an ambient light sensor and Lunar Pro, enable Sync Mode in preferences. This links your external monitor's brightness to your MacBook's ambient light readings. Free users can still use Manual Mode (100 adjustments/day) and keyboard brightness keys.
Pro Tips
- • DDC/CI works best over DisplayPort and HDMI. Some USB-C docks strip DDC/CI signals, try a different cable or adapter if hardware control doesn't work; gamma fallback still dims the image.
- • If your monitor's OSD menu has a DDC/CI option, make sure it's enabled. Some monitors ship with DDC/CI disabled by default.
- • Many users run Lunar alongside BetterDisplay: Lunar for adaptive brightness, BetterDisplay for HiDPI/resolution scaling.
- • Lunar works alongside f.lux and Night Shift without conflicts, those change color temperature while Lunar changes brightness.
Configuration Tips
Use Sync Mode for Adaptive Brightness
In Lunar Pro, set your external monitor to Sync Mode. This reads your MacBook's ambient light sensor and maps its brightness to DDC/CI values. Adjust the min/max range if the sync is too aggressive, you probably want the external monitor's range mapped to 20-90% rather than 0-100%.
Enable Sub-Zero Dimming for Night Work
Enable allow sub-zero dimming and set the minimum brightness to -20% or lower. This applies a dark overlay when DDC/CI hits the hardware minimum. The overlay reduces contrast, so don't use it for color-critical work.
Set Up App Presets for Coding vs Browsing
With Lunar Pro, create an app-specific preset for your code editor at 35% brightness (comfortable for dark themes) and another for your browser at 55% (comfortable for reading). Lunar switches between them automatically as you switch apps.
Troubleshoot DDC/CI Connection Issues
If DDC/CI doesn't work, try: (1) Enable DDC/CI in your monitor's OSD settings, (2) Use a direct DisplayPort or HDMI cable instead of a USB-C dock, (3) Try a different port on the monitor, (4) Rely on Lunar's gamma/software fallback when hardware DDC is blocked by the dock.
Pair Lunar with BetterDisplay When Needed
If you need both adaptive brightness and HiDPI/custom resolutions, install BetterDisplay alongside Lunar rather than forcing one app to do both jobs. Community write-ups often recommend Lunar for brightness and BetterDisplay for scaling.
Alternatives to Lunar
External monitor brightness and display control on macOS usually comes down to a few well-known tools:
MonitorControl
MonitorControl is the free, open-source alternative for DDC/CI brightness, contrast and volume. It lacks Lunar's Sync/Location/Sensor/Clock modes, App Presets, XDR unlock, FaceLight and BlackOut. For basic DDC/CI control, MonitorControl is excellent and free. For adaptive brightness, Lunar Pro is the upgrade.
BetterDisplay
BetterDisplay focuses on HiDPI, custom resolutions, virtual screens and broader display configuration, with some brightness/DDC options. Many Mac users run Lunar and BetterDisplay together, Lunar for adaptive brightness automation, BetterDisplay for scaling and HiDPI. Lunar is simpler and more brightness-focused.
DisplayBuddy
DisplayBuddy is another paid DDC-oriented controller with a polished UI for brightness, contrast, volume and presets. Lunar differentiates with deep adaptive modes (especially Sync), XDR/FaceLight/BlackOut tooling and a long-running free tier plus $23 lifetime Pro pricing.
macOS Built-in (Apple Displays settings)
macOS natively controls brightness on Apple-made displays (Studio Display, Pro Display XDR, MacBook screens) via Displays settings. For third-party monitors, macOS provides no DDC brightness control, that's why Lunar, MonitorControl and DisplayBuddy exist.
Pricing
Lunar's free tier includes DDC brightness/contrast/volume, sub-zero dimming, brightness and volume keys, CLI, input switching and multi-monitor support. Manual Mode is limited to 100 adjustments per day; Shortcuts actions are limited to 100 per day. Lunar Pro is a $23 one-time lifetime license with a 14-day trial. Pro unlocks unlimited adjustments plus Sync, Location, Sensor and Clock modes, App Presets, XDR Brightness, FaceLight and BlackOut. For basic external monitor brightness control, the free version is often enough. For adaptive Sync Mode and the automation features people buy Lunar for, Pro is the upgrade that matters.
Pros
- ✓DDC/CI hardware brightness control for external monitors, the way it should work
- ✓Sync Mode and other adaptive modes keep external monitors matched to ambient light
- ✓Sub-zero dimming on the free tier goes below hardware minimum for dark environments
- ✓Keyboard brightness keys work on external monitors
- ✓App Presets adjust brightness automatically when switching apps
- ✓XDR brightness unlock, FaceLight and BlackOut for Pro users
- ✓CLI and Shortcuts support for automation
- ✓Native Apple Silicon and Intel builds; actively maintained through Tahoe 26.x
- ✓Works with most major monitor brands (Dell, LG, BenQ, ASUS, Samsung)
- ✓Pairs cleanly with BetterDisplay for users who also need HiDPI control
Cons
- ✗DDC/CI doesn't work with all monitors or all connection types, some docks strip the signal
- ✗Sub-zero dimming reduces contrast (software overlay, not hardware)
- ✗Free Manual Mode and Shortcuts caps (100/day) push power users toward Pro
- ✗Adaptive brightness can occasionally overshoot or lag behind lighting changes
- ✗Apple Studio Display uses proprietary brightness control, so behavior differs from DDC monitors
Community & Development
Lunar is developed by Alin Panaitiu and is actively maintained, the official site, changelog and GitHub issue tracker stay current. Recent 2026 releases include v6.9.9 (macOS 26.3+ XDR sync), v6.9.10 (M5 MacBooks and MacBook Neo support, 2026-03-09), v6.10.0 (2026-04-10, recompiled with the macOS 26.4 SDK for Shortcuts), v6.10.2 (energy impact), v6.10.3 (Sync Mode wake fix) and v6.10.4 (2026-05-25, OSD fix). Lunar is frequently recommended on r/macapps, r/monitors and Mac productivity blogs; users often pair it with BetterDisplay. Visit https://lunar.fyi/ for downloads and https://lunar.fyi/changelog for release notes.
Video Tutorials
Getting Started with Lunar
More Tutorials
NEW TO MAC? Mac Tutorial for Beginners 2025
MacVince • 1.3M views
NEW TO MAC? Watch this 6 Minutes Mac Tutorial
Apple Wale Bhaiya • 515.6K views
The best Lunar Client settings? 😲 | Lunar Client
Lunar Client • 598.8K views
Frequently Asked Questions about Lunar
About the Author
Productivity & Workflow Analyst
Expert Tips for Lunar
Community buyers repeatedly treat Sync Mode—not just keyboard DDC—as the daily-driver reason to pay for Lunar Pro; free Manual Mode caps make the adaptive upgrade feel obvious for desk setups.
DDC failures through USB-C docks remain the top support pain; practitioners keep Lunar because gamma/software fallback still dims the screen when hardware DDC is stripped.
Mac display power users often run Lunar + BetterDisplay together: Lunar for adaptive brightness automation, BetterDisplay for HiDPI and resolution control.
Related Technologies & Concepts
Related Topics
Display Management
Tools for controlling monitor brightness, resolution, and arrangement.
Sources & References
Key Verified Facts
- Official site presents Lunar as intelligent adaptive brightness control for external macOS displays via DDC/CI and related modes.[cite-1]
- Lunar Pro is a $23 lifetime upgrade unlocking Sync/Location/Sensor/Clock modes, App Presets, XDR Brightness, FaceLight, BlackOut, and unlimited adjustments, with a 14-day trial.[cite-2]
- Changelog lists v6.10.4 (2026-05-25) as the latest release after 6.10.0 macOS 26.4 SDK Shortcuts rebuild, 6.10.2 energy impact work, 6.10.3 Sync Mode wake fix, plus earlier 6.9.10 M5/MacBook Neo and 6.9.9 macOS 26.3+ XDR sync notes.[cite-3]
- GitHub repository alin23/Lunar hosts issues and open-source components around Lunar's DDC implementation.[cite-4]
- Independent June 2026 guide on changing external monitor brightness on macOS discusses Lunar and common multi-app display setups.[cite-5]
- 1Lunar - Intelligent adaptive brightness for your external display
Accessed Aug 9, 2026
"Official website for Lunar downloads, feature overview, and DDC-based external display brightness control on macOS."
- 2Lunar Pro
Accessed Aug 9, 2026
"Official Pro page describing the $23 lifetime license, trial, and advanced adaptive modes versus free-tier limits."
- 3Lunar Changelog
Accessed Aug 9, 2026
"Official changelog documenting v6.10.4 and earlier 2026 releases including SDK rebuild, energy impact, Sync wake, and OSD fixes."
- 4GitHub - alin23/Lunar
Accessed Aug 9, 2026
"Official GitHub repository and issue tracker for Lunar's DDC-related open-source components."
- 5macOS: change brightness of external monitor
Accessed Aug 9, 2026
"June 2026 community/technical write-up on adjusting external monitor brightness on macOS, referencing practical Lunar-oriented workflows."
- 6BetterDisplay vs Lunar - LibHunt
Accessed Aug 9, 2026
"Comparison listing contrasting BetterDisplay and Lunar as macOS display utilities with different emphases."
- 7GitHub - waydabber/BetterDisplay
Accessed Aug 9, 2026
"Upstream BetterDisplay repository documenting HiDPI, resolution, and advanced display configuration features."