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]
DESCRIPTION
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 percentagestatus
Display current brightness statuslist
Show all available backlight devicesinc value
Increase brightness by percentagedec value
Decrease brightness by percentagesave
Store current brightness settingrestore
Recover previously saved brightnesssetup
Configure write permissions and udev rules (requires sudo)
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.
SEE ALSO
xbacklight(1), brightnessctl(1), light(1)
