blight

Control display backlight brightness

TLDR

Set display brightness to a percentage

$ blight set [50]

Show current brightness status

$ blight status

Increase display brightness by percentage

$ blight inc [5]

Decrease display brightness with smooth transition

$ blight dec [10] -s

List available backlight devices

$ blight list

Set brightness on a specific device

$ blight inc [2] -d [nvidia_0]

Save current brightness level for later restore

$ blight save

Restore previously saved brightness level

$ blight restore

Configure permissions and udev rules

$ sudo blight setup

SYNOPSIS

blight command [value] [options]

blight is a hassle-free CLI utility to manage backlight brightness on Linux. It plays well with hybrid GPU configurations and proprietary drivers, intelligently detecting the active graphics device.The utility prioritizes integrated graphics, followed by dedicated Nvidia GPU and ACPI kernel module, so you do not need to manually specify which device is active.

PARAMETERS

-d, --device device

Target a specific backlight device (e.g., nvidia0, amdgpubl0)

-s, --sweep

Enable smooth brightness transitions instead of instant changes

SUBCOMMANDS

set value

Set brightness to specified percentage

status

Display current brightness status

list

Show all available backlight devices

inc value

Increase brightness by percentage

dec value

Decrease brightness by percentage

save

Store current brightness setting

restore

Recover previously saved brightness

setup

Configure write permissions and udev rules (requires sudo)

INSTALL

sudo apt install blight

CAVEATS

Requires write access to sysfs backlight files. Run `sudo blight setup` once to configure udev rules and permissions, or add your user to the video group manually. Only works with displays that expose backlight control through sysfs.