Skip to content

About

A backlight daemon that allows you to set the brightness of all kinds of monitors at once

Resources

Stars

0 stars

Watchers

1 watching

Forks

Repository files navigation

backlightd

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.

Install

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.

Use

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 bars

A 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.

Brightness that feels natural

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.

Configure

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.

About

A backlight daemon that allows you to set the brightness of all kinds of monitors at once

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages