alin23/Lunar
Lunar
Lunar is an adaptive monitor brightness controller and DDC/CI display manager. It allows for the control of hardware brightness, contrast, and volume on external monitors using native communication protocols. When direct hardware control is unavailable, it functions as a software gamma dimmer to simulate brightness reduction.
The project synchronizes external monitor brightness with laptop light sensors, wireless lux meters, or astronomical sun position calculations. It also manages hardware monitor presets, enabling the automation of display configurations and input switching through custom shortcuts and application-based triggers.
Its broader capabilities include managing display power states, accessing hidden screen resolutions, and rotating display orientation. It provides a command line interface for querying display status and programmatically controlling hardware values.
Features
- Hardware Brightness Management - Manages hardware brightness, volume, and contrast directly via native communication protocols to avoid software overlays.
- Adaptive Brightness Automation - Automatically adjusts external display brightness based on ambient light sensors, sun position, or scheduled time.
- Ambient Lighting Synchronization - Synchronizes display brightness and color temperature with laptop sensors, solar data, and wireless lux meters.
- DDC/CI Controllers - Implements a DDC/CI controller to send low-level hardware commands to external monitors via the Display Data Channel protocol.
- Display Volume Controllers - Provides hardware-level volume control for external monitors using system keys and custom hotkeys.
- Hardware Display Managers - Controls power states and hardware-level settings for monitors lacking direct native software integration.
- External Monitor Managers - Manages hardware settings like brightness, volume, and contrast on external monitors using native communication protocols.
- Brightness Level Adjustments - Provides adaptive brightness and contrast adjustments based on external sensors and astronomical data.
- DDC-CI Monitor Brightness Controls - Adjusts the hardware brightness and contrast of external monitors using DDC/CI protocols and light sensors.
- Display Gamma Management - Simulates brightness reduction by manipulating display gamma curves when hardware control is unavailable.
- Display Workflow Automation - Creates presets and shortcuts to quickly switch screen resolutions, orientations, and input sources for different tasks.
- Command Line Interfaces - Provides a command-line interface to programmatically control monitor hardware and query display status.
- Ambient Light Sensors - Integrates with ambient light sensors to retrieve real-time lux measurements for adaptive brightness control.
- Sensor Integrations - Integrates with third-party wireless lux sensors via a local server to trigger brightness adjustments.
- Astronomical Solar Position Calculations - Determines sun elevation based on coordinates and time to automate brightness shifts according to solar position.
- Display Configuration Presets - Enables the creation of custom shortcuts to automate complex configurations of brightness, contrast, and screen layouts.
- Hardware Input Port Switching - Changes the active hardware input port, such as HDMI or DisplayPort, via keyboard shortcuts.
- Gamma Ramps - Manipulates system gamma ramps to simulate brightness reduction when hardware-level control is unavailable.
- Cross-Device Brightness Synchronization - Mirrors the adaptive brightness adjustments of a MacBook's built-in light sensor to all connected external monitors.
- Brightness Preset Managers - Automatically activates specific brightness and contrast presets when targeted applications are launched.
- Display Configuration Presets - Automates display configurations and input switching through custom shortcuts and application-based triggers.
- Temporal Brightness Scheduling - Automatically adjusts monitor backlight levels based on fixed timetables or astronomical events like sunrise and sunset.
- Ultra-Low Brightness Dimming - Reduces perceived screen brightness below the monitor's minimum hardware threshold for low-light environments.
- Display Profile Automations - Automatically applies monitor brightness and contrast presets when specific applications are launched or schedules are met.
- High-Brightness Display Support - Enables increasing the brightness of professional XDR panels beyond default system software limits.
