Control your laptop backlight and external monitors together, with one command. backlightd runs in the background and can gradually adjust brightness around sunrise and sunset. Use it for desktop keybindings, status bars, or automatic brightness; hotplugged monitors inherit the current target.
Built for Linux with systemd and udev. Laptop screens use Linux's backlight interface; external monitors require DDC/CI support.
Download a package for your distribution and CPU from GitHub Releases. See the installation guide for package commands, hardware requirements, and building from source, or the NixOS guide for declarative setup.
backlightctl # Show brightness and mode
backlightctl -b 60% # Set all screens to 60%
backlightctl -b +5% # Increase brightness by 5 percentage points
backlightctl --auto # Resume automatic brightness
backlightctl --json # Status for scripts and status barsA manual adjustment overrides automatic brightness for 12 hours by default, including time suspended. See the CLI reference for all commands and integrations for shortcuts and Waybar setup.
Human light perception is nonlinear. By default, backlightd maps your logical percentage through a power curve (exponent 2.0), giving finer control at the dim end. Status bars show your logical target; the daemon handles hardware mapping and rounding underneath. Some adjacent percentages may use the same hardware step, and equal percentages need not look equally bright on different monitors. The curve is configurable globally or per monitor; use exponent 1.0 for linear control. See brightness and calibration.
Settings live in /etc/backlightd/config.toml, with comments explaining each
option. Configure automatic schedules, location, manual override duration, and
per-monitor brightness ranges or curves. IP location lookup is opt-in.
The user wiki covers configuration and reloads, automatic brightness, calibration, and troubleshooting.
For developer guides and the IPC API, run cargo doc --workspace --no-deps --open.
See AGENTS.md for contributor guidance and
packaging documentation for the release workflow.