brightnessctl

Control device brightness

TLDR

List devices with changeable brightness

$ brightnessctl -l

Print the current brightness

$ brightnessctl get

Print brightness of a specific device

$ brightnessctl get -d '[device_name]'

Set brightness to a percentage

$ brightnessctl set [50]%

Increase brightness by a percentage

$ brightnessctl set +[10]%

Decrease brightness by a percentage

$ brightnessctl set [10]%-

SYNOPSIS

brightnessctl [options] command [arguments]

brightnessctl reads and controls device brightness on Linux systems. It supports display backlights, keyboard backlights, and other brightness-controllable devices through the sysfs interface.The tool can adjust brightness using absolute values or percentages, with support for increment and decrement operations.

PARAMETERS

-d, --device name

Specify device (supports wildcards)

-c, --class class

Device class (backlight, leds)

-s, --save

Save state before change

-r, --restore

Restore saved state

-q, --quiet

Suppress output

SUBCOMMANDS

list (or -l)

List all devices with controllable brightness

get (or g)

Get current brightness value

set (or s)

Set brightness to a value or percentage

max (or m)

Get maximum brightness value

INSTALL

sudo apt install brightnessctl

sudo dnf install brightnessctl

sudo pacman -S brightnessctl

sudo apk add brightnessctl

sudo zypper install brightnessctl

nix profile install nixpkgs#brightnessctl

CAVEATS

Requires appropriate permissions (often the video group membership). Not all devices support fine-grained brightness control. Minimum brightness may not be zero.

RESOURCES

Source code