Skip to content
Switch branches/tags

Latest commit


Failed to load latest commit information.

Lunar - control your monitors, even on M1

Now with M1 support

Intelligent adaptive brightness for your external display

Support Server

Note: Lunar changes the actual (physical) brightness and contrast of the monitor.

It doesn't use a software overlay.

Table of Contents

Installation methods

Display Page

Display page

Configuration Page

Configuration page

Hotkeys Page

Hotkeys page


It doesn't interfere at all with the native adaptive brightness that macOS implements for the built-in display.

It works well along Night Shift and True Tone (and f.lux if Gamma/Software controls are not used).

Tested and known to work with the following types of connections

  • HDMI (1.0 - 2.1)
  • DisplayPort (1.0 - 2.0)
  • Thunderbolt 3 (USB Type-C)
  • Thunderbolt 2 (mini DisplayPort)
  • VGA
  • DVI
  • Adapters that forward DDC messages properly


Check the FAQ


  • Lunar usually doesn't work with monitors connected through USB hubs/docks/adapters because a lot of them don't forward DDC messages properly
  • Sync mode doesn't work when the Macbook lid is closed because the light sensor is completely covered


I'm pausing contributions for the moment as Lunar has paid features and isn't compilable because of missing parts of the source code.


Lunar can't be built from this repo yet as the source code for the paid features is hidden. I will try to post stubs for those paid features to at least make it compilable in an only-free-features form.