homebridge / homebridge/plugins

Verification Request: homebridge-ups-monitor

Open
#1,068 15 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

awaiting-final-review request-verification
Dominant language
TypeScript
Stars
369
Forks
24
PR merge metrics
No merged PRs in 30d

Description

Plugin Name

homebridge-ups-monitor

Link To GitHub Repo

https://github.com/Plimmerton-Labs/homebridge-ups-monitor

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

Published: npm latest is 1.5.0; every release has a GitHub release with notes. ~198 tests; CI across Node 18–24; ESLint + CodeQL + npm-audit in CI.

Relationship to the verified homebridge-ups: homebridge-ups (by @ebaauw) is HomeKit-centric — it exposes and controls the UPS inside Apple Home and keeps Eve-app history. homebridge-ups-monitor adds an observability & data-portability layer that lives outside Apple Home, which homebridge-ups does not provide:

  • a standalone web dashboard reachable from any browser on the network (phone, tablet, desktop) — no Home app or Eve required;
  • history charts (1h / 6h / 12h / 24h) backed by a server-side ring buffer;
  • CSV / log export (24h and 30-day daily logs) for spreadsheets and long-term analysis;
  • broad HomeKit tiles plus optional UPS controls (beeper toggle, low-battery threshold sync), making it a functional superset for in-Home use as well.

The two can run side by side; this plugin targets cross-platform monitoring and exportable history rather than competing as an Apple-Home bridge.

Contributor guide

Open the contributing guide

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.

Research direction

Start by reviewing the verification checklist in this issue and the linked homebridge-ups-monitor repository, including its releases, tests, CI, and relationship to homebridge-ups. Done means the plugin’s eligibility has been assessed and the verification request has a clear maintainer decision.

Written by the indexing model from the issue text.

Assessment

Tech stack
nodejs, typescript
Domain
documentation
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.