Skip to content
Very simple program to control the backlight brightness of a laptop
C Roff Makefile M4 Shell
Branch: master
Clone or download
troglobit Travis-CI: Require newer Ubuntu for a modern pkg-config
Signed-off-by: Joachim Nilsson <>
Latest commit ae79d50 Jul 19, 2019

Backlight Control

License Badge Travis Status

Simple program to control backlight brightness of laptops in Linux.

troglobit@example:~$ backlight -h

Usage: backlight [options] [command]

 -h    This help text
 -v    Show program version

 up    Increase brightness
 down  Decrease brightness

Bug report address:

The program has only two commands: up and down, which adjusts the brightness up or down, respectively. Without arguments the current (raw) brightness value read from /sys/class/backlight/*/brightness is displayed.

Brightness is controlled using an exponential scale to provide a smooth transition from max to min.

Setup in Awesome

Users of the Awesome WM can update their ~/.config/awesome/rc.lua to include the following:

    -- Brightness
    awful.key({ }, "XF86MonBrightnessUp", function () os.execute("backlight up") end,
              {description = "Increase brightness", group = "hotkeys"}),
    awful.key({ }, "XF86MonBrightnessDown", function () os.execute("backlight down") end,
              {description = "Decrease brightness", group = "hotkeys"}),

Reload Awesome and your brightness keys will now work as expected.

You can’t perform that action at this time.