Configuration

Configuring calise is not optional, if not configured the program cannot run.

To start calibration run: $ calise --calibrate

After you successfully complete last step of calibration you can finally run calise. Take a look at Usage for usage scenarios and which is the one that fits better for you.

Calibration steps
Exhaustive explanation of every calibration step.

Profile Name
If it's not the first time you run calibration AND your not executing as root, on this passage you'll be asked to enter a valid profile name. The profile is not written to disk until you end successfully last step of calibration.

Multiple profiles can be useful if you usually use the same machine in the same places (eg: you take the laptop to work, then you use that same laptop again but this time in your room during the evening)

Backlight interface
There, if your system has more than one sysfs backlight interface, you're asked to choose one of them. If you're undecided on which of them you should choose try:

if more than one interface changed its value then go harder...

if even with that last script more than one backlight interface changed the backlight, just randomly choose one of them and, if after you start using calise you notice you choose the wrong one, delete default profile and re-run calibration or re-run calibration specifying "default" as profile name.

Backlight Steps
The program needs to know which's minimum backlight of the interface selected on passage 2 (sysfs only holds maximum level). As first attempt the program tries to find minimum backlight level itself and asks for confirmation. If the user does not confirm within default timer expires (20 seconds) assumes that that was not the lower backlight level.

If so, you are asked to manually change backlight level to minimum and let the program read what's.

Geolocation
There the program tries to obtain your geolocation (latitude and longitude).

At first it tries to do a geoip lookup and asks for confirm.

If that fails (no internet connection or user denial), tries to search geolocation coordinates in existing profiles and, if so, asks for confirm.

If also that fails (user denial), asks directly the user to enter coordinates as comma separated float degrees.

If the user leaves blank, then no geolocation is written on the output profile.

Camera
There, if your system has more than one camera, you're asked to choose one of them.

Cannot help much there... if you're undecided just choose one and if it was wrong re-run calibration.

Minimum brightness
The program needs to know which's minimum brightness level that camera chosen on step 5 can register (this varies a lot from cam to cam but a "normal value can considered from 0.0 to 30.0").

To achieve that only one method come to my mind... you need to cover the camera (better with the thumb).

Brightness Scale
On this passage you're asked to choose a backlight level (either as percentage or baclight step number) corresponding to ambient brightness of that very moment.