homebridge-seasons

Homebridge plugin that exposes the seasons of the year as HomeKit contact sensors for use in seasonal automations.

Acknowledgement

This project is a fork of homebridge-seasons, adding Homebridge UI configuration options and Homebridge 2.x support. It also updates the seasons to show in HomeKit as contact sensors for easy automation conditions. Thank you @naofireblade for creating the original code and for passing the original npm name on for this updated version.

Requirements

• Node.js 20.0.0 or later
• Homebridge 1.8.0 or later (including Homebridge 2.x)

Installation

Using the Homebridge UI

Search for homebridge-seasons in the Homebridge UI plugin search and install it.

Using npm

npm install -g homebridge-seasons

Configuration

You can configure the plugin using the Homebridge UI or by editing your config.json directly.

Example configuration

"platforms": [
    {
        "platform": "Seasons",
        "hemisphere": "north",
        "useAstronomicCalendar": false
    }
]

Configuration options

| Option | Required | Default | Description | | --- | --- | --- | --- | | platform | Yes | — | Must be "Seasons". | | hemisphere | No | "north" | "north" or "south". Determines which hemisphere's seasons to use. | | useAstronomicCalendar | No | false | When enabled, uses solstices and equinoxes for precise seasonal dates. When disabled, uses fixed months (e.g., Dec-Feb for Winter, Mar-May for Spring). |

How it works

The plugin creates four HomeKit contact sensors — one for each season (Spring, Summer, Fall, Winter). The sensor for the current season reports as "Open" while the other three report as "Closed". This makes it easy to build HomeKit automations that trigger on seasonal changes, for example adjusting lighting scenes or thermostat schedules.

Meteorologic calendar (default)

Seasons are determined by fixed month ranges:

| Season | Months | | --- | --- | | Spring | March – May | | Summer | June – August | | Fall | September – November | | Winter | December – February |

Astronomic calendar

When useAstronomicCalendar is enabled, seasons are determined by approximate solstice and equinox dates:

| Season | Start date | | --- | --- | | Spring | March 20 (Spring Equinox) | | Summer | June 21 (Summer Solstice) | | Fall | September 22 (Fall Equinox) | | Winter | December 21 (Winter Solstice) |

If hemisphere is set to "south", seasons are inverted (e.g., June is Winter instead of Summer).