# Technical Documentation: alin23/Lunar > ℹ️ **Provenance:** Hybrid Fusion: `alin23/Lunar` (README + 1 In-Tree Chapters) · [CodeWiki Reference](https://codewiki.google/github.com/alin23/Lunar) · Recency: Active (< 180 days) ## 1. Project Overview & Quickstart (alin23/Lunar) #### macOS app for controlling monitors, [with native support for both Intel and Apple Silicon](https://lunar.fyi/#m1) ## Community [](https://discord.gg/dJPHpWgAhV) ## DDC/CI Lunar changes the hardware brightness of the monitor using the DDC protocol. It doesn't use a software overlay if the monitor supports DDC/CI. ## Installation methods - Download [Lunar.dmg](https://lunar.fyi/download/latest) from [lunar.fyi](https://lunar.fyi/) - Or `brew install --cask lunar` ## Features - **[Native keyboard control](https://lunar.fyi/#keys)** and hotkeys for setting brightness, volume and contrast that respect the min/max values per monitor - **[1000-to-1600 nits of brightness](https://lunar.fyi/#xdr)** for supported **XDR** and **HDR** displays - **[Dim brightness below 0%](https://lunar.fyi/#subzero)** for late-night work - **[Sensor-based Adaptive Brightness](https://lunar.fyi/#sensor)** (and contrast) based on [an external light sensor](https://lunar.fyi/sensor) - **[Sync-based Adaptive Brightness](https://lunar.fyi/#sync)** (and contrast) based on **the built-in light sensor of the MacBook or iMac** - **[Location-based Adaptive Brightness](https://lunar.fyi/#location)** (and contrast) based on the sunrise/sunset times in your location - **[App Presets](https://lunar.fyi/#configuration-page)** if you need more/less brightness for specific activities (watching movies, design work) - **[Input switching](#input-hotkeys)** from a convenient dropdown or using up to 3 input-specific hotkeys - **[Screen orientation](https://lunar.fyi/#display-settings-page)** change from the menu bar or using hotkeys (Ctrl+0/9/8/7 mapped to 0°/90°/180°/270° for the display with the cursor on it) - **[Hidden resolutions](https://lunar.fyi/#display-settings-page)** accessible from a dropdown in the [Display Settings menu](#display-settings) - **[BlackOut](https://lunar.fyi/#blackout)**: turn off monitors (or the built-in display) selectively while also keeping important functions: - USB-C charging still works - Monitor audio keeps playing - Monitor USB hub remains available - The built-in keyboard and trackpad are still available for use - Avoid overheating the MacBook because of using it with the lid closed 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 dimming is not used). ## QuickActions Menu ## Display Page ## Display Settings ## Built-in Display Page ## Display Input Hotkeys ## Configuration Page ## Hotkeys Page ## Tested and known to work with the following types of connections - HDMI (1.0 - 2.1) - DisplayPort (1.0 - 2.0) - Thunderbolt 4 (USB Type-C) - Thunderbolt 3 (USB Type-C) - Thunderbolt 2 (mini DisplayPort) - VGA - DVI - Adapters that forward DDC messages properly ### Contributing I'm pausing contributions for the moment as Lunar has paid features and isn't compilable because of missing parts of the source code *(Pro features code is encrypted)*. ### Building Lunar can't be built from this repo as the source code for the paid features is hidden. ## 2. In-Tree Documentation Chapters (alin23/Lunar) #### macOS app for controlling monitors, [with native support for both Intel and Apple Silicon](https://lunar.fyi/#m1) ## Community [](https://discord.gg/dJPHpWgAhV) ## DDC/CI Lunar changes the hardware brightness of the monitor using the DDC protocol. It doesn't use a software overlay if the monitor supports DDC/CI. ## Installation methods - Download [Lunar.dmg](https://lunar.fyi/download/latest) from [lunar.fyi](https://lunar.fyi/) - Or `brew install --cask lunar` ## Features - **[Native keyboard control](https://lunar.fyi/#keys)** and hotkeys for setting brightness, volume and contrast that respect the min/max values per monitor - **[1000-to-1600 nits of brightness](https://lunar.fyi/#xdr)** for supported **XDR** and **HDR** displays - **[Dim brightness below 0%](https://lunar.fyi/#subzero)** for late-night work - **[Sensor-based Adaptive Brightness](https://lunar.fyi/#sensor)** (and contrast) based on [an external light sensor](https://lunar.fyi/sensor) - **[Sync-based Adaptive Brightness](https://lunar.fyi/#sync)** (and contrast) based on **the built-in light sensor of the MacBook or iMac** - **[Location-based Adaptive Brightness](https://lunar.fyi/#location)** (and contrast) based on the sunrise/sunset times in your location - **[App Presets](https://lunar.fyi/#configuration-page)** if you need more/less brightness for specific activities (watching movies, design work) - **[Input switching](#input-hotkeys)** from a convenient dropdown or using up to 3 input-specific hotkeys - **[Screen orientation](https://lunar.fyi/#display-settings-page)** change from the menu bar or using hotkeys (Ctrl+0/9/8/7 mapped to 0°/90°/180°/270° for the display with the cursor on it) - **[Hidden resolutions](https://lunar.fyi/#display-settings-page)** accessible from a dropdown in the [Display Settings menu](#display-settings) - **[BlackOut](https://lunar.fyi/#blackout)**: turn off monitors (or the built-in display) selectively while also keeping important functions: - USB-C charging still works - Monitor audio keeps playing - Monitor USB hub remains available - The built-in keyboard and trackpad are still available for use - Avoid overheating the MacBook because of using it with the lid closed 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 dimming is not used). ## QuickActions Menu ## Display Page ## Display Settings ## Built-in Display Page ## Display Input Hotkeys ## Configuration Page ## Hotkeys Page ## Tested and known to work with the following types of connections - HDMI (1.0 - 2.1) - DisplayPort (1.0 - 2.0) - Thunderbolt 4 (USB Type-C) - Thunderbolt 3 (USB Type-C) - Thunderbolt 2 (mini DisplayPort) - VGA - DVI - Adapters that forward DDC messages properly ### Contributing I'm pausing contributions for the moment as Lunar has paid features and isn't compilable because of missing parts of the source code *(Pro features code is encrypted)*. ### Building Lunar can't be built from this repo as the source code for the paid features is hidden. --- METRICS --- - Files Extracted: 2 - Estimated Token Budget: ~1611 tokens - Recency Window: Active (< 180 days) - Canonical Reference: https://codewiki.google/github.com/alin23/Lunar