Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/alin23/lunar
Intelligent adaptive brightness for your external monitors
https://github.com/alin23/lunar
adaptive-brightness brightness brightness-control contrast ddc ddc-ci display macbook macos monitor swift swiftui volume-control xdr
Last synced: 26 days ago
JSON representation
Intelligent adaptive brightness for your external monitors
- Host: GitHub
- URL: https://github.com/alin23/lunar
- Owner: alin23
- License: mit
- Created: 2018-07-03T17:23:54.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2024-04-01T11:15:52.000Z (7 months ago)
- Last Synced: 2024-04-01T12:31:20.446Z (7 months ago)
- Topics: adaptive-brightness, brightness, brightness-control, contrast, ddc, ddc-ci, display, macbook, macos, monitor, swift, swiftui, volume-control, xdr
- Language: Swift
- Homepage: https://lunar.fyi
- Size: 806 MB
- Stars: 4,261
- Watchers: 28
- Forks: 101
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- open-source-mac-os-apps - Lunar - Intelligent adaptive brightness for your external displays. ![swift_icon] (Applications / Utilities)
- open-source-mac-os-apps - Lunar - Intelligent adaptive brightness for your external displays. ![swift_icon] (Applications / Utilities)
- awesome-swift-macos-apps - Lunar - Intelligent adaptive brightness for your external displays. (Utilities / Text)
- awesome-swift-macos-apps - Lunar - Intelligent adaptive brightness for your external displays. (Utilities / Text)
README
Lunar
The defacto app for controlling monitors
Adjust brightness, change volume, switch inputs
#### 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.