Release 3.0.0

This is a beta release for version 3

3.0.0

Change log:

• Added ability to set xy color range in place of color temperature range
• Allow for RGB to be preferred over color temperature if a light supports both

Release 2.1.1

Fix bug with class naming in 2.1.0.

Release 2.1.0

This release contains some bug fixes, new features, and breaking changes

Bugfixes

• Fix error checking when color temperature units are not submitted as 'mired' or 'kelvin'
• Other minor fixes

New Features

• Sleep color temperature is now available as a configuration option, this sets the color temperature when sleep mode is active, the default is still the minimum color temperature
• You can now set prefer RGB boolean. This allows you to always use RGB to change the light color temperature, even if the light supports color temperature.

Breaking change

• The red hour option has been removed. It was legacy and doesn't make much sense anymore. The behavior to expect now is that when sleep mode is active, it is active. If you still want a time constraint you can use a TOD binary sensor in Home Assistant, and use that as part of sleep mode.

Release 2.0.1

Important please read

If you are coming from 1.0.0 please read the change-log for 2.0.0 before updating. There were breaking changes!

Minor bug fix

• This release is a minor bug fix to handle if the start time is before the end time without crossing midnight.
• Update the name in HACS
• Minor ReadMe updates

Release 2.0.0

This release has some important updates/bug fixes and some potential breaking changes. Please read carefully.

Minor breaking changes

• The core algorithm has been changed to a simpler and less logically complex equation. The result of this is a smooth transition over the course of 24 hours rather than the previous method which set lights to the maximum brightness / color temp immediately at the end time and did not start dimming until the start time. Some testing indicates that during the start->end period the results are very similar (within a few percent), and outside of the start->end period the percentage is near 100% but fit to a periodic function so only 100% for a brief period.
• The keep lights on Boolean was initially intended to only keep the lights on during the start->end period, however, it was keeping lights on 24 hours. This has been fixed, but if you relied on lights being on 24 hours this will now be 'broken'
• There is a longstanding bug where some lights, when turned off, temporarily use an assumed state, then the light is polled and the light comes back on, then reports off. This caused the app to intercept the 'on' command and would then adjust the light back on. This problem plagues many apps like this and further explanation is here. To solve this, when a light is turned off, the app ignores it for 5 seconds. The obvious problem here is if the user intended to turn the light back on it will be ignored for those 5 seconds.

Major breaking change

• The sensor log has been reworked and greatly improved. Previously this sensor displayed the 'dimming percentage'. This made little sense and no longer uses this. Any use of this sensor in other apps or automations will need to be reworked. See below for sensor update.

Feature updates

• Renamed to Periodic lights
• New more robust algorithm to calculate brightness and color temperature
• The sensor log now displays the current light brightness. There are now attributes for the sensor that include: color temperature (various formats), start->end midpoint, both index midpoints
• The sensor log is now created by default with the format sensor.[app name]. You can still specify a sensor log name
• You can now create an app instance with no lights defined by setting sensor only to True. This allows for just the creation of a sensor that tracks light brightness / color temp as well as the other attributes. This sensor can be used by other automations, or just to observe the behavior of the app with various inputs.
• Added ability to specify sleep color for 'red hour'. A list of acceptable colors is here.

Bug fixes

• Fix issue where some lights would stubbornly not turn off
• Fix issue where keep lights on would keep them on 24 hours rather than from start->end

v1.0.0

This has been stable for some time, so might as well track releases.

This release adds support for:

• Added support for event subscription
• Allow for disabling time-based updates
• Allow for disabling listening for light state update