© 2011-2012 Pau Oliva Fora - pof[at]eslack(.)org
Lightum is a daemon to control the keyboard brightness and screen backlight on MacBook based laptops.
By default it will run in "auto" mode, this means it will read data from the ambient light sensor (located on the iSight camera) and automatically:
It will also dim the keyboard brightness and screen backlight when the computer is not used for a configurable amount of seconds.
If you choose to run it in "manual" mode, it will not query the ambient light sensor, but instead it will use the brightness and backlight values you set manually using the function keys.
When first launched lightum will create a configuration file inside the user's home directory with the default configuration values:
~/.config/lightum/lightum.conf
When launched without parameters, lightum will read the configuration from this config file, but the configuration values can be overwritten via the command line:
Usage: lightum [OPTION]...
-m 4..255 : maximum brightness value in auto mode (default=255)
-n 0..3 : minimum brightness value in auto mode (default=0)
-M 7..15 : maximum backlight value in auto mode (default=15)
-N 1..6 : minimum backlight value in auto mode (default=1)
-p num : number of milliseconds between light sensor polls (default=300)
-i num : power off keyboard light on session idle seconds (0 to disable)
-I num : turn down screen backlight on session idle seconds (0 to disable)
-w num : 1 manage brightness, 2 manage backlight, 3 both (default:3)
-x : manual mode (will honor the brightness value set with Fn keys)
-l : fully dim the screen backlight when session is idle
-u : do not ignore brightness changes happening outside lightum
-U : ignore session information from ConsoleKit
-s : power off keyboard light when screen saver is active
-f : run in foreground (do not daemonize)
-v : verbose mode, useful for debugging with -f and -d
-d num : debug mode: 1 brightness, 2 backlight, 3 both
Official Ubuntu packages are available in poliva/lightum-mba ppa:
sudo add-apt-repository ppa:poliva/lightum-mba
sudo apt-get update
sudo apt-get install lightum
(Tested on Ubuntu 13.04)
sudo apt-get install build-essential
git clone https://github.com/poliva/lightum
and cd
into the project's directory.sudo apt-get install libxss-dev libdbus-glib-1-dev
make
sudo make install
An indicator applet is also available to control lightum from your desktop panel.
Enjoy! :)