Verification Request: homebridge-ecobee-security
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
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
Plugin Name
homebridge-ecobee-security
Link To GitHub Repo
https://github.com/seanfletchr/homebridge-ecobee-security
Plugin Icon (Optional)
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
- No Dockerfile or Docker Compose file
- No pull request template
- Read the contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from homebridge/plugins
-
awaiting-final-review request-icon
Difficulty 1/5 Under an hour Newbie friendliness 70/100
homebridge/plugins#1376 · 1 comment ·
-
awaiting-final-review request-verification
Difficulty 2/5 1-3 hours Newbie friendliness 65/100
homebridge/plugins#1331 · 2 comments ·
-
awaiting-final-review request-verification
Difficulty 2/5 1-3 hours Newbie friendliness 62/100
homebridge/plugins#1288 · 1 comment ·
-
awaiting-changes request-icon
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
homebridge/plugins#1222 · 8 comments ·
-
awaiting-final-review request-verification
Difficulty 4/5 3-5 days Newbie friendliness 35/100
homebridge/plugins#1374 · 2 comments ·
All issues in homebridge/plugins
Similar issues
-
P2
Difficulty 1/5 Under an hour Newbie friendliness 84/100
Maintainers usually reply within 1 day
-
bug ready-for-human
Difficulty 2/5 1-3 hours Newbie friendliness 60/100
LucasSantana-Dev/Lucky#3150 ·
Maintainers usually reply within 1 day
-
enhancement good first issue priority: low size: XS
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
Maintainers usually reply within 1 day
-
area: testing bug priority: low
Difficulty 2/5 1-3 hours Newbie friendliness 87/100
snapotter-hq/SnapOtter#5099 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
EveryInc/compound-engineering-plugin#2091 ·
Maintainers usually reply within 1 day