homebridge-konnected-v2

About this fork

This is a community-maintained fork of the original homebridge-konnected plugin created by Mike Kormendy. The original was last updated for Homebridge 1.x; this fork updates it to run on Homebridge 2.x and adds new functionality. All credit for the original plugin goes to Mike Kormendy and the Konnected community — see Credits below.

It is published to npm under a new name (homebridge-konnected-v2) so it can coexist with the original. This fork is not affiliated with or endorsed by konnected.io or the original author, and is not (currently) a Homebridge Verified plugin.

What's New in This Fork

• Homebridge 2.x compatibility. Updated engine requirements (Node.js 22/24, Homebridge 1.8+/2.x) and verified against the Homebridge 2.x / HAP-NodeJS v2 type definitions.
• Per-mode entry & exit delays. You can now set different entry and exit delay times for each arming mode — Home/Stay, Night, and Away — instead of one shared value for all modes. See Per-Mode Entry & Exit Delays.
• Dependency & security cleanup. Removed the deprecated ip package (replaced with Node's built-in os) and the uuid package (replaced with Node's built-in crypto.randomUUID()), and removed a preinstall script that modified the user's system. No new runtime dependencies were added.

Supported Features

Installation

Install through the Homebridge UI by searching for homebridge-konnected-v2 on the Plugins tab, or from the command line:

npm install -g homebridge-konnected-v2

Requirements: Homebridge v1.8+ or v2.x running on Node.js 22 or 24.

After installing, configure the plugin from the Homebridge UI's plugin settings screen (the configuration form is provided automatically).

Configuration

The core configuration (panels, zones, sensor and switch assignments, security-system behaviour) is unchanged from the original plugin. The original project's wiki remains the most complete reference for those options:

• Installation
• Configuration
• Particulars
• Troubleshooting

Note: those wiki pages describe the original plugin. Everything there still applies to this fork, with the additions documented below.

Per-Mode Entry & Exit Delays

The original plugin used a single entry delay and a single exit delay applied to every arming mode. This fork lets you set a different delay per HomeKit arming mode — Home/Stay, Night, and Away — for both entry and exit.

How it works:

• The existing Delay (seconds) field is now the shared default — it applies to any mode that does not have its own override.
• New optional override fields appear under both Entry Delay Settings and Exit Delay Settings in the plugin settings: a Home/Stay, Night, and Away delay.
• Leave an override blank to fall back to the shared delay. A value of 0 means instant (no delay) for that mode.
• The exit delay and the audible beeper countdown are now independent: a mode can have a silent exit delay (a delay with no beeping), which wasn't possible before.

These fields are available in the Homebridge UI settings form — no manual JSON editing required. If you do edit config.json directly, the relevant section looks like this:

"advanced": {
  "entryDelaySettings": {
    "delay": 30,
    "delayHome": 0,
    "delayNight": 0,
    "delayAway": 45
  },
  "exitDelaySettings": {
    "delay": 30,
    "delayHome": 0,
    "delayNight": 10,
    "delayAway": 60,
    "audibleBeeperModes": ["1"]
  }
}

In this example: Away uses a 45-second entry and 60-second exit delay with an audible countdown; Night has no entry delay and a silent 10-second exit delay; Home/Stay is instant; and any mode without an override falls back to the shared 30-second value.

This is fully backward compatible — an existing configuration that only sets delay behaves exactly as before, with that value applied to every mode.

Credits

This plugin would not exist without the original work of Mike Kormendy, who created and maintained homebridge-konnected. If you find this plugin useful, please consider supporting Mike for the original work via GitHub Sponsors, PayPal, or Ko-fi.

Thanks also to the contributors acknowledged in the original project, including @bwp91, @oznu, @NorthernMan54, and @mkellsy, and to the Homebridge and Konnected communities.

License

Released under the MIT License. Original work Copyright 2021 konnected.io / Mike Kormendy. Fork modifications Copyright 2025 the fork maintainer(s).