backward-compatibile xbacklight replacement
Latest commit 5fe6628 Nov 26, 2016 @wavexx Also shortcut steps == 1
Failed to load latest commit information.
90-backlight.rules Provide the udev rules file. Oct 31, 2016
COPYING.txt Make github happy Nov 26, 2016
README.rst Initial version. Mar 4, 2016
xbacklight Also shortcut steps == 1 Nov 26, 2016


acpilight: a backward-compatibile xbacklight replacement

"acpilight" is a backward-compatibile replacement for xbacklight, that uses the ACPI interface to set the display brightness.


On some modern laptops "XRandR" might lack the ability to set the display brightness. This capability was moved/unified to the kernel's ACPI interface, via /sys/class/backlight/.

"xbacklight" provides a drop-in replacement for the same command, using the ACPI interface instead of "XRandR" in order to let old scripts run. As a result, "xbacklight" can now also be used from the console and Wayland (X11 is not used at all).


Normally, users are prohibited to alter files in the sys filesystem. It's advisable to setup an "udev" rule to allow users in the "video" group to set the display brightness.

To do so, place a file in /etc/udev/rules.d/90-backlight.rules containing:

SUBSYSTEM=="backlight", ACTION=="add", RUN+="/bin/chgrp video /sys/class/backlight/%k/brightness"
SUBSYSTEM=="backlight", ACTION=="add", RUN+="/bin/chmod g+w /sys/class/backlight/%k/brightness"

to setup the relevant permissions at boot time.

Authors and Copyright

"acpilight" is distributed under GPLv3+ (see COPYING) WITHOUT ANY WARRANTY.
Copyright(c) 2016 by wave++ "Yuri D'Elia" <>.