Verification Request: homebridge-ecobee-security

Open
#1,273 5 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
15/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Active
Tech stack
node.js, typescript
Domain
backend, security

Research direction

This is a Homebridge verification request, so the work is a maintainer review of the linked plugin repo rather than a code change. Start with the checklist in the issue body and the README, CHANGELOG.md and state.json handling in https://github.com/seanfletchr/homebridge-ecobee-security. Done means each checklist item is confirmed or flagged in the thread by a Homebridge maintainer.

Written by the indexing model from the issue text.

Description

awaiting-final-review request-verification
Plugin Name

homebridge-ecobee-security

Link To GitHub Repo

https://github.com/seanfletchr/homebridge-ecobee-security

Plugin Icon (Optional)
Image
The plugin does not offer the same nor less functionality than that of any existing verified plugin.

🟢 Yes

The plugin successfully installs and does not start unless it is configured.

🟢 Yes

The plugin does not require the user to run Homebridge in a TTY or with non-standard startup parameters, even for initial configuration.

🟢 Yes

The plugin does not contain any analytics or calls that enable you to track the user.

🟢 Yes

If the plugin needs to write files to disk (cache, keys, etc.), it stores them inside the Homebridge storage directory.

🟢 Yes

The plugin does not throw unhandled exceptions, the plugin must catch and log its own errors.

🟢 Yes

More Information

homebridge-ecobee-security brings ecobee Smart Security back to Apple Home. ecobee removed Smart Security from its own HomeKit integration, so the alarm system (Stay / Away / disarm, and the alarm state) is no longer available in HomeKit otherwise.

Difference from the verified homebridge-ecobee-status: that plugin uses HomeKit's security-system tile to switch an ecobee thermostat's comfort settings (Home / Away / Sleep). This plugin controls ecobee's actual Smart Security alarm system: arming Stay or Away (with ecobee's exit delay), disarming, and showing Alarm triggered when ecobee opens an intrusion or smoke incident. It also adds a Smoke Sensor for ecobee's smoke-alarm detection and Air Quality / CO2 sensors for ecobee Premium thermostats, which ecobee's own HomeKit integration doesn't expose.

Setup: sign-in happens in the plugin's custom settings page (email, password, then the MFA code). The password is sent only to ecobee's sign-in service and is never stored; the plugin saves a refresh token in its config and keeps the current one in <storage>/ecobee-security/state.json (mode 600). A browser-based sign-in is offered as a fallback in the same page. No terminal is needed.

API: ecobee has no public API for Smart Security, so the plugin uses the same cloud API as the ecobee iOS app (Auth0 sign-in, GraphQL, and ecobee's REST API for thermostat air quality), signing in with the app's client ID. The README says this clearly, and that the plugin is not affiliated with ecobee. There are no analytics; the only network calls are to ecobee's own servers.

Files: everything is written under the Homebridge storage directory (ecobee-security/state.json and a Unix control socket, mode 600, that lets other plugins on the same host ask for a temporary Stay).

Releases: every version has a GitHub release with notes; CHANGELOG.md in the repo. Runs on Node 22 and 24, Homebridge 1.8 and 2.x; no dependencies besides @homebridge/plugin-ui-utils; no install scripts.

Dominant language
TypeScript
Stars
371
Forks
26
Avg merge
1h
Merged PRs (30d)
5

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from homebridge/plugins

All issues in homebridge/plugins

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.