Skip to content
Federico edited this page Nov 8, 2018 · 8 revisions

Config file

A global config file is shipped with clight. It is installed in /etc/default/clight.conf and it is full of comments.
You can customize it or you can copy it in your $XDG_CONFIG_HOME folder (fallbacks to $HOME/.config/) and customize it there.
Both files are checked when clight starts, in this order: global -> user-local -> cmdline opts.

CmdLine options

For cmdline options, check clight [-?|--help] [--usage].
Note that a bash autocompletion script is installed together with clight.

Polynomial fit

Clight makes use of Gnu Scientific Library to compute best-fit around data points as read by clight.conf file.
Default values on AC are [ 0.0, 0.15, 0.29, 0.45, 0.61, 0.74, 0.81, 0.88, 0.93, 0.97, 1.0 ]; indexes (from 0 to 10 included) are our X axys (ambient brightness), while values are Y axys (screen backlight).
For example, with default values, at 0.5 ambient brightness (6th value in this array) clight will set a 74% of max backlight level.
By customizing these values, you can adapt screen backlight curve to meet your needs. Note that values must be between 0.0 and 1.0 obviously.
Clight supports different curves on different ac states. In fact, by default on BATT points are different from above. See config file for more info.

Gamma support info

Gamma support is only available on X. Sadly on wayland there is still no standard way to achieve gamma correction. Let's wait with fingers crossed.
Consequently, on not X environments, gamma correction tool gets autodisabled.
As clightd getgamma function properly supports only 50-steps temperature values (ie if you use "setgamma 6000" and then getgamma, it will return 6000. If you use setgamma 4578, getgamma won't return exactly it; it will return 4566 or something similar.), do not set in your conf not-50-multiple temperatures.
If you run clight from wayland or from a tty, gamma support will be automatically disabled.

Clone this wiki locally