homebridge-automation-calendar icon indicating copy to clipboard operation
homebridge-automation-calendar copied to clipboard

Useful calendar information for HomeKit automations (seasons, week of the year, month of the year, morning twilight / sunrise / daytime / sunset / evening twilight / night)

Automation - Calendar

Example config.json:

    "accessories": [
        {
            "accessory": "AutomationCalendar",
            "name": "Test",
            "latitude": 51.4825747,
            "longitude": -0.0251685
        }  
    ]

This accessory will create a fake sensor with some custom characteristics. Use one or more characteristic to limit the automation to a specific period of time (e.g. only during the winter or only during the day).

Configuration

  • latitude your home latitude (used for astronomical calculations); e.g. -33.8567844
  • longitude your home longitude (used for astronomical calculations); e.g. 151.2152967

Characteristics exposed

Month of the year

The current month (1 is January, 2 is February, ..., 12 is December).

Week of the year

The week of the year, according to the Node.js locale. See moment.js documentation for more info.

Season

The current astronomical season, based on the latitude/longitude provided.

Season Enum Value
Spring 1
Summer 2
Autumn 3
Winter 4

Season name

The label of the current season (it cannot be used for automation, use the Season characteristic instead).

Time of the day

The time of the day, based on the latitude/longitude provided.

Time of the day Enum Value
Morning Twilight 1
Sunrise 2
Daytime 3
Sunset 4
Evening Twilight 5
Nighttime 6

Time of the day label

The label for the current type of the day (it cannot be used for automation, use the Time of the day characteristic instead).

How to access the characteristics

The native Home app does not display all other characteristics. For that you have to use the Home+ or Eve app.