Skip to content

Verification Request: homebridge-shelly-zepra #1377

Closed

Description

@ZEPRA-SW

Plugin Name

homebridge-shelly-zepra

Link To GitHub Repo

https://github.com/ZEPRA-SW/homebridge-shelly-zepra

Plugin Icon (Optional)

No response

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

Please consider Shelly ZEPRA for verification. This request covers version 1.2.4 of homebridge-shelly-zepra. It combines supported Shelly device integration, independent Venetian-blind slat control, solar-shading automation and a local Scene engine in one dynamic Homebridge platform.

The differentiating value is the integrated automation and configuration workflow, beyond exposing device controls in HomeKit:

Separate height and slat control: compatible Venetian blinds can expose slat position as a separate HomeKit accessory, independently from blind height.

Built-in solar automation: per-device orientation and sun limits, configurable start/end offsets, sun-position-based slat adjustment, manual pauses and wind-alarm handling.

Local Scenes: nested AND/OR conditions, confirmation durations, schedules, ordered actions, delays, intermediate conditions with timeouts and optional restoration of previous target states. Each Scene has a condition-status indicator and a history of its ten most recent events.

Dew-point conditions: select temperature and relative-humidity sources, inspect a live dew-point preview and compare the result in degrees Celsius with thresholds, hysteresis and confirmation durations. Missing, faulty or stale readings do not satisfy a condition or trigger restoration. The calculation reuses existing status feedback and adds no regular device polling.

WS90 weather-station support: the Ecowitt WS90 Powered by Shelly integration maps battery, illuminance, rain status, wind speed, gust speed, UV index, wind direction, air pressure, reported dew point, capacitor voltage, relative humidity, temperature and reported precipitation. Wind and gusts use km/h. Reported precipitation remains an amount in mm without assuming an hourly or daily interval. Missing or invalid measurements remain unavailable; legitimate zero and false values remain valid.

BTHome sensors on shading hosts: sensors can be configured directly on an existing blind/shutter Shelly. Sensor reads share its existing connection and request queue, while sensor freshness remains independent from cover feedback.

Direct sensor selection in Scenes: a dedicated Sensors group provides a two-stage workflow, first choosing a station/sensor and then its measurement. The existing Shelly host and sensor mapping are assigned automatically. A read-only information line shows the current sensor value, On/Off state or dimming level. Status refreshes do not overwrite condition thresholds or change actions.

A complete interface in German, English, French and Spanish, including settings, status views, Scenes, help, validation and event history.

One bridge with separate general-device and shading areas, supporting configured local or Shelly Cloud connections. A shared cloud-request queue coordinates multiple server/key combinations and rate-limit cooldowns.

The requested distinction is this combination of device support, independent slat operation and user-facing local automation. Supported models, firmware requirements and connection-specific limitations are documented in the README. This is not a claim that every Shelly model or firmware feature is supported, or that no other plugin implements an individual feature.

The project provides a settings GUI, public source code, issues and release notes. Release 1.2.4 has passed all GitHub CI jobs: Node 22, 24 and 26 with Homebridge 1 and 2, plus the browser suite. Local validation passed 622 automated tests under Node 24/Homebridge 1 and Node 26/Homebridge 2. Browser validation includes 170 combined-interface checks, 189 WS90 checks, 169 shading/BTHome checks, 180 direct-sensor-selection checks and 273 current-feedback checks. Relevant interfaces are checked in all four languages, including Scene localization and dew-point previews. CI report.

Tests use real Homebridge/HAP libraries with simulated transport. They are not a substitute for exhaustive live testing of every listed model, firmware or optional feature. The maintainer has confirmed the WS90 integration in practical use; the latest current-feedback display has automated/browser coverage and still requires live installation confirmation.

Runtime state is stored in the Homebridge storage directory. The plugin contains no user analytics or tracking and has no system-modifying installation hooks. Configuration and time-zone failures are caught and logged before device startup, preserving existing accessory context and stored state. Tests cover request failures, sensor outages, stale/future-dated readings, shutdown during an in-flight read and preservation of accessory identities. Actual sensor measurement timestamps are retained and checked during Scene evaluation: polling an unchanged host cache does not make an old measurement fresh or count as a new sample for a confirmation duration.

The maintainer reports practical integration testing and use of the following models and accessories.

Switching and dimming:

Shelly Plus 1 Mini.

Shelly 1 Gen3.

Shelly 1 Mini Gen3.

Shelly Plus 2PM.

Shelly 2PM Gen3.

Shelly Plus i4.

Shelly Plug S (Gen1).

Shelly Plug S Gen3.

Shelly Plus 0–10V Dimmer.

Shelly Pro 1PM.

Shelly Pro 3.

Shelly Pro 4PM.

Shelly Pro Dimmer 2PM.

Energy measurement and displays:

Shelly EM (Gen1).

Shelly Pro 3EM.

Shelly Wall Display (4-inch).

Shelly Wall Display XL (10.1-inch).

Sensors and extensions:

Shelly BLU Door/Window.

Shelly BLU H&T.

Shelly BLU Motion.

Shelly Sensor Add-on.

Ecowitt WS90 Powered by Shelly weather station.

The documented shading tests with Shelly Plus 2PM and 2PM Gen3 include blind-height control and independent slat control. For Shelly EM (Gen1), the specifically documented checks cover read-only identification and both measurement channels. The broader list reflects maintainer-reported practical testing and use.

Coverage refers to functions exposed by the plugin, not every optional feature, firmware version or connection mode. BTHome button-event streaming on shading hosts is not implemented; custom read-only weather characteristics depend on the HomeKit application's display support.

GitHub repository · npm package

We welcome the Homebridge team's review and any requested changes. Feedback, suggestions and bug reports are welcome at pm@zepra-app.de.

Activity

  1. github-actions commented on Nov 20, 2026

    @github-actions
    Contributor

    🔴 Failed Checks

    • Package JSON: keywords must include at least one of 'supports-hap' or 'supports-matter' — see Declaring Supported Transports
    • GitHub Repo: version mismatch - NPM has v1.1.1 but GitHub package.json has v1.2.4
    • Dependencies: homebridge must only be in devDependencies (not dependencies, optionalDependencies, bundledDependencies, or peerDependencies — npm auto-installs peer deps)

    🟢 Passed Checks

    • Installation: successfully installed
    • Package JSON: homepage exists
    • Package JSON: bugs.url exists and seems a valid URL
    • Package JSON: keywords exist and contain 'homebridge-plugin'
    • Package JSON: 'preinstall' in scripts is not present
    • Package JSON: 'install' in scripts is not present
    • Package JSON: 'postinstall' in scripts is not present
    • Package JSON: engines.node property is compatible with Node 22
    • Package JSON: engines.node property is compatible with Node 24
    • Package JSON: engines.homebridge property is compatible with Homebridge 2.5.0
    • Package JSON: initializer function found
    • NPM Package: has not been deprecated
    • Config Schema JSON: exists and is valid JSON
    • Config Schema JSON: contains valid JSON Schema
    • Config Schema JSON: schema has valid type property
    • Config Schema JSON: schema has valid properties for object type
    • Config Schema JSON: contains a valid pluginAlias
    • Config Schema JSON: pluginAlias matches the platform/accessory registered in code
    • Config Schema JSON: the pluginType is set to 'platform'
    • Config Schema JSON: contains a name schema property
    • Dependencies: hap-nodejs is not declared as a runtime/peer/bundled dependency
    • Security: no known vulnerabilities in dependencies
    • Security: no unsafe code patterns detected
    • Security: no privilege escalation attempts detected
    • GitHub Repo: repository is public
    • GitHub Repo: repository is not archived
    • GitHub Repo: issues are enabled
    • GitHub Repo: contains releases

    ℹ️ Check Details

    • These checks were run against v1.1.1 of the plugin.
    • Link to the run workflow: visit →.

    📋 Next Steps

    • Once you have fixed these failures, comment /check on this issue to run the checks again — your request will not move forward until the checks are re-run.
    • If updating your package.json and config.schema.json files, don't forget to publish a new version to NPM.
    • Remember this is an automatic script: if you think something has been marked as a failure in error, let us know with a reply.
    • Feel free to ask any questions you have by replying to this issue.
  2. added
    awaiting-changesuse after review has started - awaiting user to make changes to plugin
    and removed
    pendingthe label given to a new verification/icon request
    on Nov 20, 2026
  3. ZEPRA-SW commented on Nov 20, 2026

    @ZEPRA-SW
    Author

    /check

  4. added
    pendingthe label given to a new verification/icon request
    and removed
    awaiting-changesuse after review has started - awaiting user to make changes to plugin
    on Nov 20, 2026
  5. github-actions commented on Nov 20, 2026

    @github-actions
    Contributor

    🟢 Passed Checks

    • Installation: successfully installed
    • Package JSON: homepage exists
    • Package JSON: bugs.url exists and seems a valid URL
    • Package JSON: keywords exist and contain 'homebridge-plugin'
    • Package JSON: keywords declare the supported transports ('supports-hap' and/or 'supports-matter')
    • Package JSON: 'preinstall' in scripts is not present
    • Package JSON: 'install' in scripts is not present
    • Package JSON: 'postinstall' in scripts is not present
    • Package JSON: engines.node property is compatible with Node 22
    • Package JSON: engines.node property is compatible with Node 24
    • Package JSON: engines.homebridge property is compatible with Homebridge 2.5.0
    • Package JSON: initializer function found
    • NPM Package: has not been deprecated
    • GitHub Repo: version in package.json (v1.2.5) matches NPM version (v1.2.5)
    • Config Schema JSON: exists and is valid JSON
    • Config Schema JSON: contains valid JSON Schema
    • Config Schema JSON: schema has valid type property
    • Config Schema JSON: schema has valid properties for object type
    • Config Schema JSON: contains a valid pluginAlias
    • Config Schema JSON: pluginAlias matches the platform/accessory registered in code
    • Config Schema JSON: the pluginType is set to 'platform'
    • Config Schema JSON: contains a name schema property
    • Dependencies: homebridge is not declared as a runtime/peer/bundled dependency
    • Dependencies: hap-nodejs is not declared as a runtime/peer/bundled dependency
    • Security: no known vulnerabilities in dependencies
    • Security: no unsafe code patterns detected
    • Security: no privilege escalation attempts detected
    • Runtime: homebridge installed successfully
    • Runtime: no config - homebridge should start without plugin configuration and plugin should not load
    • Runtime: platform only - plugin should start with just platform property
    • Runtime: full config - plugin should start with comprehensive configuration
    • Runtime: plugin shuts down cleanly within 12s of SIGTERM
    • Runtime: plugin restarts cleanly without port conflicts
    • GitHub Repo: repository is public
    • GitHub Repo: repository is not archived
    • GitHub Repo: issues are enabled
    • GitHub Repo: contains releases

    ℹ️ Check Details

    • These checks were run against v1.2.5 of the plugin.
    • Link to the run workflow: visit →.

    📋 Next Steps

    All checks passed successfully, nice work! Your plugin and/or icon will now be manually reviewed by the Homebridge team.

  6. added a commit that references this issue on Nov 20, 2026
  7. added
    verifieduse when a plugin meets the criteria - adds the verified badge text
    on Nov 20, 2026
  8. github-actions commented on Nov 20, 2026

    @github-actions
    Contributor

    Congratulations! Your plugin has been verified!

    You can now add one of the Verified by Homebridge badges to your plugin's README:

    verified-by-homebridge

    [![verified-by-homebridge](https://img.shields.io/badge/_-verified-blueviolet?color=%23491F59&style=flat&logoColor=%23FFFFFF&logo=homebridge)](https://github.com/homebridge/homebridge/wiki/Verified-Plugins)
    

    verified-by-homebridge

    [![verified-by-homebridge](https://img.shields.io/badge/homebridge-verified-blueviolet?color=%23491F59&style=flat)](https://github.com/homebridge/homebridge/wiki/Verified-Plugins)
    

    verified-by-homebridge

    [![verified-by-homebridge](https://img.shields.io/badge/homebridge-verified-blueviolet?color=%23491F59&style=for-the-badge&logoColor=%23FFFFFF&logo=homebridge)](https://github.com/homebridge/homebridge/wiki/Verified-Plugins)
    

    Your plugin is now also eligible to display a ❤️ Donate button on its tile in the Homebridge UI. See https://github.com/homebridge/homebridge/wiki/Donation-Links for instructions.

    Interested in getting a @homebridge-plugins/ scope for your plugin? See our Homebridge Scoped Plugins program.

    If for any reason in the future you can no longer maintain your plugin, please consider transferring it to our Homebridge Plugins organization.

    Don't forget to join the official Homebridge Discord server, where plugin developers can get tips and advice from other developers and the Homebridge project team in the #plugin-development channel!

    As a verified plugin, you can request a channel in the Discord server to discuss your plugin with users and other developers. Just ask in the #plugin-development channel.

    Thank you for your contribution to the Homebridge community.

    • The Homebridge Team
  9. bwp91 commented on Nov 20, 2026

    @bwp91
    Contributor

    Thanks for the quick fixes after the first check, and for contributing to Homebridge!

    There are a few verified Shelly plugins already, but yours adds a lot they don't have: separate slat control for Venetian blinds, the solar shading and the scenes. So I'm happy to verify it.

    One small suggestion: the time zone defaults to Europe/Berlin. For users outside Germany it might be worth defaulting to the system's own time zone, so the shading times are right without changing the setting.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    request-verificationverifieduse when a plugin meets the criteria - adds the verified badge text

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions