homebridge-season-switch

A Homebridge plugin that provides a virtual switch automatically toggled by month.
This is useful for seasonal automation such as switching between cooling and heating modes.

Features

• Creates a virtual HomeKit Switch
• Automatically turns ON / OFF based on the current month
• Fully configurable via config.json
• Supports year-crossing seasons (e.g. November → April)
• Can be manually controlled from the Home app
• Ideal for seasonal air-conditioner automation

Example Use Case

• Use one physical smart button to toggle an air conditioner
• Decide cooling or heating mode by season, not by room temperature
• Example:
  • May–October → Cooling
  • November–April → Heating

  "accessories": [
    {
      "accessory": "SeasonSwitch",
      "name": "[Name display in Home app]",
      "onFromMonth": 5,
      "offFromMonth": 11
    }
  ]

Installation

npm install -g homebridge-season-switch