A Python library that automatically sets the color of an LIFX light based on your RescueTime productivity.
This library communicates with your light using the LIFX API and gets your daily productivity using the RescueTime API. You will need a key from both of these services.
You can also use the optional "Circadian" mode. With this enabled, the Kelvin temperature of your LIFX light will change throughout the day to correlate with natural light. Your local sunrise and sunset times are retreived using ipgeolocation.io's free astronomy API, so you will need a key to use this feature.
First, your net-productivity in hours is calculated by subtracting your distracting time today from your productive time. The semi-productive/distracting time is weighted only 50%
Your light's hue will then bet set depending on if this value is positive or negative. By default, green indicates more productive time than distracting time while red indicates the opposite.
The saturation of this color is calculated by dividing your net-productivity by a scale factor. This factor is preset to 10 hours, but can be configured (as can your choices for hues). So, if you had 8 productive hours today and 3 unproductive hours, your light would be green with a saturation of 50%. If net-productivity is 0, the color will simply be white.
The human body's work and sleep schedule naturally follows changes in sunlight, especially changes in blue light exposure throughout the day. Circadian mode mimics these changes by adjusting the light's temperature to be warmer or bluer based on the time.
At night, the light will be a warm 2500K, similar to a candle. Beginning an hour and a half before sunrise, the temperature will gradually cool until it reaches a peak of 7500K at sunrise. During daytime, the temperature will slowly decrease back to 4500K at sunset. From there, the temperature will quickly warm to the night temperature over the following hour and a half of twilight.
Overall, these changes in color and temperature are meant to promote a healthy and productive schedule.
Dependencies required:
- datetime
- requests
Implementing the main functionality of Productivity Light is easy:
from productivity_light import productivity_light
productivity_light(lifx_token='insert lifx api key here', rt_token='insert rescuetime api key here')
This will begin an infinite loop of getting your daily productivity from RescueTime and setting the color of your LIFX light. You can keep this running on your machine or as a background task on a server.
To enable Circadian mode, pass in the additional parameters circadian=True and ct_token='your ipgeolocation api key'.
Additional configuration is possible by setting any of the following parameters:
- scale: number of hours of net productive/distracting time for the light color to reach max saturation, default 10
- prod_hue: hue (in degrees) of the light's color when net daily productivity is positive, default 137 (green)
- dist_hue: hue (in degrees) of the light's color when net daily productivity is negative, default 0 (red)
- cycle_length: length in seconds of how often the light color should be updated, default 300
- light_index: the index of the light to use (you may need to experiment with this in multi-light setups), default 0
- debug: True/False option to display debug info in console, default False
- log_url: optional url to send RescueTime data to log on a personal server
If you are creating a custom implementation, this library provides a wrapper for using the LIFX API to set the color of a light and using the RescueTime API to download productivity data.