https://github.com/claytonjn/hass-circadian_lighting
Circadian Lighting custom component for Home Assistant
https://github.com/claytonjn/hass-circadian_lighting
circadian circadian-rhythms hacs home-assistant lighting sleep wellness
Last synced: 19 days ago
JSON representation
Circadian Lighting custom component for Home Assistant
- Host: GitHub
- URL: https://github.com/claytonjn/hass-circadian_lighting
- Owner: claytonjn
- License: apache-2.0
- Created: 2019-04-03T18:29:22.000Z (about 6 years ago)
- Default Branch: main
- Last Pushed: 2025-03-08T16:43:58.000Z (about 2 months ago)
- Last Synced: 2025-03-30T21:05:46.382Z (26 days ago)
- Topics: circadian, circadian-rhythms, hacs, home-assistant, lighting, sleep, wellness
- Language: Python
- Homepage:
- Size: 179 KB
- Stars: 806
- Watchers: 19
- Forks: 94
- Open Issues: 105
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-home-assistant - Circadian Lighting - Circadian Lighting slowly synchronizes your color changing lights with the regular naturally occuring color temperature of the sky throughout the day. (Custom Integrations / Alternative Dashboards)
README
# Circadian Lighting [[Home Assistant](https://www.home-assistant.io/) Component]
## Stay healthier and sleep better by syncing your lights with natural daylight to maintain your circadian rhythm!
Circadian Lighting slowly synchronizes your color changing lights with the regular naturally occurring color temperature of the sky throughout the day. This gives your environment a more natural feel, with cooler hues during the midday and warmer tints near twilight and dawn.
In addition, Circadian Lighting can set your lights to a nice cool white at 1% in “Sleep” mode, which is far brighter than starlight but won’t reset your circadian rhythm or break down too much rhodopsin in your eyes.
Expand for articles explaining the benefits of maintaining a natural Circadian rhythm
* [Circadian Rhythms - National Institute of General Medical Sciences](https://www.nigms.nih.gov/Education/Pages/Factsheet_CircadianRhythms.aspx)
* [Circadian Rhythms Linked to Aging and Well-Being | Psychology Today](https://www.psychologytoday.com/us/blog/the-athletes-way/201306/circadian-rhythms-linked-aging-and-well-being)
* [Maintaining a daily rhythm is important for mental health, study suggests - CNN](https://www.cnn.com/2018/05/15/health/circadian-rhythm-mood-disorder-study/index.html)
* [How Nobel Winning Circadian Rhythm Research Benefits Pregnancy](https://www.healthypregnancy.com/how-nobel-prize-winning-circadian-rhythms-research-benefits-a-healthy-pregnancy/)
* [Body Clock & Sleep - National Sleep Foundation](https://sleepfoundation.org/sleep-topics/sleep-drive-and-your-body-clock)
* [How our body’s circadian clocks affect our health beyond sleep](https://www.theverge.com/2018/6/12/17453398/sleep-circadian-code-satchin-panda-clock-health-science)### Visit the [Wiki](https://github.com/claytonjn/hass-circadian_lighting/wiki) for more information.
## Basic Installation/Configuration Instructions:
#### Installation:
Install `custom_component` files automatically using [HACS](https://github.com/claytonjn/hass-circadian_lighting/wiki/Installation-Instructions#hacs) or [Custom Updater](https://github.com/claytonjn/hass-circadian_lighting/wiki/Installation-Instructions#custom-updater), or install [Manually](https://github.com/claytonjn/hass-circadian_lighting/wiki/Installation-Instructions#manual-installation).[](https://github.com/hacs/integration)
#### Component Configuration:
```yaml
# Example configuration.yaml entry
circadian_lighting:
```
[_Advanced Configuration_](https://github.com/claytonjn/hass-circadian_lighting/wiki/Advanced-Configuration#component-configuration-variables)#### Switch Configuration:
```yaml
# Example configuration.yaml entry
switch:
- platform: circadian_lighting
lights_ct:
- light.desk
- light.lamp
```
Switch configuration variables:
* **name** (_Optional_): The name to use when displaying this switch.
* **lights_ct** (_Optional_): array: List of light entities which should be set in mireds.
* **lights_rgb** (_Optional_): array: List of light entities which should be set in RGB.
* **lights_xy** (_Optional_): array: List of light entities which should be set in XY.
* **lights_brightness** (_Optional_): array: List of light entities which should only have brightness adjusted.[_Advanced Configuration_](https://github.com/claytonjn/hass-circadian_lighting/wiki/Advanced-Configuration#switch-configuration-variables)
### Graphs!
These graphs were generated using the values calculated by the Circadian Lighting sensor/switch(es).##### Sun Position:
##### Color Temperature:
##### Brightness:
