homebridge-calendar-scheduler

2.2.2 • Public • Published

📅 Homebridge Calendar Scheduler verified-by-homebridge

Support Ukraine Badge "Buy Me A Coffee" "Ko-fi"

npm npm npm

Creating and maintaining Homebridge plugins consume a lot of time and effort, if you would like to share your appreciation, feel free to "Star" or donate.

Click here to review more of my plugins.

Info

Calendar Scheduler plugin for Homebridge, which allows flexible scheduling of triggers with event progress report using any iCal calendar.

Installation

After Homebridge has been installed:

sudo npm install -g --unsafe-perm homebridge-calendar-scheduler@latest

Example Config

{
  "platforms": [
    {
      "platform": "CalendarScheduler",
      "debug": false,
      "calendars": [
        {
          "calendarName": "calendar-1",
          "calendarUrl": "https://calendar.google.com/calendar/ical/{...}.ics",
          "calendarUpdateInterval": 3,
          "calendarTriggerOnUpdates": true,
          "calendarUpdateButton": false,
          "calendarEvents": [
            {
              "eventName": "event-name1"
            },
            {
              "eventName": "event-name-with-retrigger",
              "eventTriggerOnUpdate": true
            }
          ]
        },
        {
          "calendarName": "calendar-2",
          "calendarUrl": "https://calendar.google.com/calendar/ical/{...}.ics",
          "calendarUpdateInterval": 30,
          "calendarTriggerOnUpdates": false,
          "calendarTriggerOnAllEvents": true,
          "calendarEvents": [
            {
              "eventName": "event-name-without-retrigger",
              "eventTriggerOnUpdate": false
            },
            {
              "eventName": "^event-(.*)",
              "eventTriggerOnUpdate": false,
              "calendarEventNotifications": [
                {
                  "notificationName": "event-notification-name-before-start-15m",
                  "notificationStartOffset": -15
                },
                {
                  "notificationName": "event-notification-name-after-start-15m",
                  "notificationStartOffset": 15
                },
                {
                  "notificationName": "event-notification-name-before-end-15m",
                  "notificationEndOffset": -15
                },
                {
                  "notificationName": "event-notification-name-after-end-15m",
                  "notificationEndOffset": 15
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}
Config Field Description Default Required
platform Must always be CalendarScheduler. "CalendarScheduler" Yes
caseInsensitiveEventsMatching Enable for case insensitive events matching globally. false No
unsafeEventNames Enable unsafe events names globally. (Be careful as this may cause unexpected behavior.) false No
debug Enable for displaying debug messages. false No
calendars Array of watched calendars. [] No
Calendar Config Field Description Default Required
calendarName A unique name for the calendar. Will be used as the accessory name and default sensor for any calendar events. "calendar-name1" Yes
calendarUrl The address of the calendar. Can be a webcal://, a http:// or an https:// URL. "" Yes
calendarUpdateInterval The polling interval the plugin uses to retrieve calendar updates in minutes. If not set, the plugin will update the calendar ones in 60 minutes. 60 No
calendarUpdateButton If set to true, then button for manual update available for this calendar accessory. true No
calendarTriggerOnUpdates If set to true, then every minute calendar sensor trigger update if any defined event is active. true No
calendarTriggerOnAllEvents If set to true, then calendar sensor trigger update if any event is active. false No
caseInsensitiveEventsMatching Enable for case insensitive events matching for this calendar. false No
unsafeEventNames Enable unsafe events names for this calendar. (Be careful as this may cause unexpected behavior.) false No
calendarEvents Array of watched calendar events. [] No
Calendar Event Config Field Description Default Required
eventName A unique name for the calendar event. Will be used as calendar sensor for matched calendar event. Note that this can either be an event name or more generally a regular expression. "event-name1" Yes
eventTriggerOnUpdates If set to true, then every minute sensor trigger update for active event. true No
caseInsensitiveEventsMatching Enable for case insensitive events matching for this event. false No
unsafeEventNames Enable unsafe events names for this event. (Be careful as this may cause unexpected behavior.) false No
calendarEventNotifications Array of calendar event notifications. [] No
Calendar Event Notification Config Field Description Default Required
notificationName A unique name for the calendar event notification. notificationStartOffset or notificationEndOffset field is required to make it work. "notification-name1" Yes
notificationStartOffset Amount of time in minutes before the event start to trigger the notification. If positive, then notification will be triggered after the event start. If negative, then notification will be triggered before the event start. undefined No
notificationEndOffset Amount of time in minutes after the event end to trigger the notification. If positive then notification will be triggered after the event end. If negative, then notification will be triggered before the event end. undefined No

Contributing

You can contribute to this homebridge plugin in following ways:

  • Report issues and help verify fixes as they are checked in.
  • Review the source code changes.
  • Contribute bug fixes.
  • Contribute changes to extend the capabilities
  • Pull requests are accepted.

See CONTRIBUTING

Package Sidebar

Install

npm i homebridge-calendar-scheduler

Weekly Downloads

7

Version

2.2.2

License

Apache-2.0

Unpacked Size

68.6 kB

Total Files

30

Last publish

Collaborators

  • uamanager