Skip to main content

an auto luxer

Project description

inspired by lumen <> but written for *nix machines. autolux takes a screenshot every few seconds, figures out the ‘average value’ of the resulting image (the luminence) and changes the screen brightness based on the screen’s contents.


pip install autolux


  • python2 (not python3)
  • imagemagick (for screenshots + determining average brightness)
  • xdotool (finding focused window)
  • xbacklight (for setting display brightness)


# runs autolux


initially, autolux uses linear interpolation to figure out the brightness to map to different luminence inputs. as the brightness is manually adjusted away from its predicted value, autolux records the time of day and luminence values that prompted you to change the brightness level and integrates the new information into its model.

autolux assumes that time of day and screen content are the sole predictors of one’s preferred brightness, but the model could further be improved by adding in several factors, such as ambient light or user active time (as a stand-in for eye strain). because of these and other unknown confounding variables, autolux has an emphasis on quick learning of new preferences and not burning in old ones.


autolux --vis --plot-bright
# show brightness prediction model
# requires matplotlib
# color is the input luminence. (5K - 65K, lower value is darker screen content)
# x axis is hour (0 - 24, with UTC offset applied)
# y axis is predicted brightness level from the model (0 - 100%)

autolux --vis --plot-luma
# --plot-luma will swap the luma and brightness on the Y axis and colorbar

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
autolux-0.0.30.tar.gz (8.1 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page