Lunar
Adaptive brightness for external displays
Lunar — Official Website
Quick Take: Lunar
Lunar fills a gap Apple has ignored for years: controlling external monitor brightness from your Mac. The free version gives you keyboard brightness control via DDC/CI—already a huge improvement over reaching for monitor buttons. Lunar Pro's adaptive brightness and sub-zero dimming make it feel like your external monitor is a native Mac display. The $23 lifetime price is fair for a tool you'll use every day. The only frustration is DDC/CI compatibility—when it works (most monitors, most connections), Lunar is excellent. When it doesn't (some USB-C docks, some monitor firmware), troubleshooting can be annoying.
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 adaptive brightness on external displays
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 (matching external monitor brightness to your MacBook's ambient light sensor), schedule-based brightness curves, per-app brightness profiles, and fine-grained color controls. The Pro version adds advanced features like sub-zero dimming (reducing brightness below the monitor's hardware minimum using a software overlay), XDR brightness control for Apple displays, and network-based control for monitors that support it. Lunar is developed by Alin Panaitiu and is one of the most well-regarded Mac utilities in the developer community. The free version handles basic DDC/CI brightness and contrast control. Lunar Pro ($23 lifetime license) adds the advanced features. 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.
Install with Homebrew
brew install --cask lunarDeep 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 on macOS, likely because Apple prefers to sell its own displays with proprietary control protocols. This created the market for Lunar and MonitorControl.
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. Some connection types (DisplayPort, HDMI) carry DDC/CI signals reliably. Others (some USB-C docks, some adapters) strip or corrupt the DDC/CI channel. Lunar includes workarounds for common failure modes, but hardware incompatibility remains the primary support issue.
Ecosystem & Integrations
Lunar exists alongside MonitorControl (free, open-source, basic DDC/CI) and BetterDisplay (comprehensive display management including DDC/CI, HiDPI, and resolution control). The three apps serve different audiences: MonitorControl for basic free brightness control, Lunar for adaptive brightness and automation, BetterDisplay for display configuration power users.
Future Development
Lunar development focuses on expanding DDC/CI compatibility (supporting more monitors and connection types), improving adaptive brightness algorithms, and adding features for Apple's evolving display ecosystem (XDR, ProMotion). The developer actively tracks new macOS releases for compatibility.
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 software brightness control.
Adaptive Brightness
When you have a MacBook with an ambient light sensor, Lunar 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.
Sub-Zero Dimming
Most monitors can't go below about 20% brightness via DDC/CI—the backlight has a hardware minimum. Lunar Pro adds 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 Profiles
Lunar Pro can automatically change brightness when you switch between apps. 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.
Schedule-Based Brightness Curves
Set a brightness schedule that follows the time of day—brighter during morning hours, gradually dimming through the evening, and very low at night. Lunar's schedule 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 Control
Apple's Pro Display XDR and MacBook Pro XDR displays support brightness above the standard 500 nits—up to 1000+ nits. macOS only enables this for HDR content by default. Lunar Pro can unlock XDR brightness for SDR content, giving you the full brightness range when you need it for daylight readability. This also works on MacBook Pro displays with the Liquid Retina XDR screen.
Keyboard Hotkeys Integration
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. This is the simplest, most used feature—it makes the brightness keys work the way everyone expects them to.
Contrast and Volume Control
Beyond brightness, Lunar can adjust contrast and volume via DDC/CI on monitors that support it. Volume control is useful for monitors with built-in speakers—adjust the monitor's speaker volume from your Mac 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 adaptive 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 mode keeps 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, adaptive 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, ensuring your monitors are calibrated to the same brightness level. The schedule feature maintains this calibration through changing ambient conditions.
How to Install Lunar on Mac
Lunar is available via Homebrew or direct download.
Install via Homebrew
Run `brew install --cask lunar` in Terminal. The app installs to /Applications. For the latest version, 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 it shows 'Software dimming', your monitor doesn't support DDC/CI over your connection type.
Configure Adaptive Mode
If you have a MacBook with an ambient light sensor, enable Sync mode in Lunar's preferences. This links your external monitor's brightness to your MacBook's ambient light readings.
Pro Tips
- • DDC/CI works best over DisplayPort and HDMI. Some USB-C connections strip DDC/CI signals—try a different cable or adapter if hardware control doesn't work.
- • 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.
- • 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's preferences, 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
In Lunar Pro, 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 Per-App Profiles for Coding vs Browsing
Create an app-specific profile 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) Check Lunar's diagnostic panel for connection details.
Alternatives to Lunar
External monitor brightness control has a few options on macOS:
MonitorControl
MonitorControl is the free, open-source alternative. It handles DDC/CI brightness, contrast, and volume control well. It lacks Lunar's adaptive brightness, sub-zero dimming, per-app profiles, and schedule features. For basic DDC/CI control, MonitorControl is excellent and free. For advanced features, Lunar Pro is worth the upgrade.
NightOwl
NightOwl automates dark mode switching on macOS, not monitor brightness. If your goal is adjusting dark/light mode appearance based on time of day, NightOwl handles that. For actual display brightness control, you need Lunar or MonitorControl.
BetterDisplay
BetterDisplay is a more comprehensive display management tool that handles brightness, resolution, HiDPI settings, and display arrangement. It includes DDC/CI control and software dimming. It's more powerful than Lunar for display configuration but also more complex. Lunar is simpler and more focused on brightness.
macOS Built-in (Apple Displays Only)
macOS natively controls brightness on Apple-made displays (Studio Display, Pro Display XDR, MacBook screens). For third-party monitors, macOS provides no brightness control at all—that's why Lunar and MonitorControl exist.
Pricing
Lunar's free version handles basic DDC/CI brightness and contrast control, keyboard hotkey integration, manual brightness adjustment, and input switching—with a limit of 100 adjustments per day. Lunar Pro ($23 one-time lifetime license) adds unlimited adjustments, adaptive brightness (Sync/Sensor/Location/Clock modes), sub-zero dimming, XDR brightness unlock, per-app profiles, BlackOut display control, FaceLight video call lighting, and command-line integrations. For basic external monitor brightness control, the free version is sufficient. For adaptive brightness and advanced features, Pro is worth the price.
Pros
- ✓DDC/CI hardware brightness control for external monitors—the way it should work
- ✓Adaptive brightness syncs external monitors with MacBook ambient light sensor
- ✓Sub-zero dimming goes below hardware minimum for dark environments
- ✓Keyboard brightness keys work on external monitors
- ✓Per-app brightness profiles adjust automatically when switching apps
- ✓XDR brightness unlock for Apple's high-brightness displays
- ✓Schedule-based brightness curves for time-of-day automation
- ✓Works with most major monitor brands (Dell, LG, BenQ, ASUS, Samsung)
Cons
- ✗DDC/CI doesn't work with all monitors or all connection types
- ✗Sub-zero dimming reduces contrast (software overlay, not hardware)
- ✗Pro features cost $23—the free version is basic
- ✗Adaptive brightness occasionally overshoots or lags behind lighting changes
- ✗Some USB-C docks strip DDC/CI signals, requiring troubleshooting
- ✗Doesn't work with Apple's Studio Display (which uses Apple-proprietary brightness control)
Community & Development
Lunar is developed by Alin Panaitiu and is actively maintained on GitHub. The project has over 5,000 stars and a responsive issue tracker. The developer is highly engaged—DDC/CI compatibility issues get quick responses because they're the core of the product. Lunar is frequently recommended on r/macapps, r/monitors, and in Mac productivity blogs. The documentation covers DDC/CI troubleshooting, monitor compatibility, and advanced configuration. Visit https://lunar.fyi/ for the latest version (currently v6.10.0 as of April 2026).
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
Our Verdict
Lunar fills a gap Apple has ignored for years: controlling external monitor brightness from your Mac. The free version gives you keyboard brightness control via DDC/CI—already a huge improvement over reaching for monitor buttons. Lunar Pro's adaptive brightness and sub-zero dimming make it feel like your external monitor is a native Mac display. The $23 lifetime price is fair for a tool you'll use every day. The only frustration is DDC/CI compatibility—when it works (most monitors, most connections), Lunar is excellent. When it doesn't (some USB-C docks, some monitor firmware), troubleshooting can be annoying.
About the Author
Productivity & Workflow Analyst
Related Technologies & Concepts
Related Topics
Display Management
Tools for controlling monitor brightness, resolution, and arrangement.
Sources & References
Key Verified Facts
- Official website confirming Lunar's primary functionality: controlling the brightness, contrast, and volume of external monitors on macOS using DDC/CI.[cite-1]
- Official documentation explaining how Lunar uses the Display Data Channel (DDC) protocol to send hardware-level brightness commands to external displays like Dell, LG, and BenQ.[cite-2]
- Official documentation detailing how Lunar integrates with external ambient light sensors (like the Xiaomi Mijia) to automatically adjust external monitor brightness based on room lighting.[cite-3]
- Official page outlining the feature differences between the free version and Lunar Pro, including limits on Sync Mode and advanced XDR brightness unlocking.[cite-4]
- The official GitHub repository for Lunar, serving as the issue tracker and providing open-source components of the app's DDC implementation for macOS.[cite-5]
- 1Lunar - Intelligent adaptive brightness for your external display
Accessed May 6, 2026
"Official website confirming Lunar's primary functionality: controlling the brightness, contrast, and volume of external monitors on macOS using DDC/CI."
- 2Lunar FAQ - DDC Support
Accessed May 6, 2026
"Official documentation explaining how Lunar uses the Display Data Channel (DDC) protocol to send hardware-level brightness commands to external displays like Dell, LG, and BenQ."
- 3Lunar Sensor Mode
Accessed May 6, 2026
"Official documentation detailing how Lunar integrates with external ambient light sensors (like the Xiaomi Mijia) to automatically adjust external monitor brightness based on room lighting."
- 4Lunar Pro vs Free Comparison
Accessed May 6, 2026
"Official page outlining the feature differences between the free version and Lunar Pro, including limits on Sync Mode and advanced XDR brightness unlocking."
- 5GitHub - alin23/Lunar: The defacto app for controlling monitor brightness
Accessed May 6, 2026
"The official GitHub repository for Lunar, serving as the issue tracker and providing open-source components of the app's DDC implementation for macOS."
- 6Lunar Releases - GitHub
Accessed May 6, 2026
"Release notes confirming native Apple Silicon (M1/M2/M3/M4/M5) support for DDC control over HDMI and DisplayPort without requiring Rosetta 2, and latest v6.10.0 updates."
- 7The Journey to DDC on M1 Macs
Accessed May 6, 2026
"A technical publication by Lunar's developer detailing the reverse-engineering of the M1 Mac's I2C registers required to enable hardware brightness control on Apple Silicon."
- 8How to Change External Monitor Brightness on Your Mac
Accessed May 6, 2026
"A technology publication article recommending Lunar as a primary solution for bypassing macOS limitations to control third-party external monitor brightness using native keyboard keys."
- 9Control external display brightness with your Mac's keyboard
Accessed May 6, 2026
"Tech publication review highlighting Lunar's 'Sync Mode' which successfully matches the external monitor's brightness curve to the built-in MacBook display."
- 10Lunar Changelog
Accessed May 6, 2026
"Official changelog documenting version history, recent fixes, and improvements including macOS 26.4 SDK support and M5 MacBook compatibility."