Skip to content

Verification Request: homebridge-pax-calima #1302

Closed
Closed
Verification Request: homebridge-pax-calima#1302
Labels
request-verificationverifieduse when a plugin meets the criteria - adds the verified badge text

Description

@KernowekConsulting
KernowekConsulting
opened on Oct 26, 2026

Plugin Name

homebridge-pax-calima

Link To GitHub Repo

https://github.com/KernowekConsulting/homebridge-pax-calima

Plugin Icon (Optional)

SvaraHome icon

Approved SvaraHome artwork, square 100 × 100 PNG. The original artwork is included in the repository; it is not a manufacturer logo.

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 review SvaraHome 2.5.0, published as the stable version of homebridge-pax-calima.

SvaraHome is a dynamic platform for local Bluetooth control of Pax Calima and Vent-Axia Svara extractor fans. It offers timed Boost and Pause, return to automatic ventilation, measured speed feedback and optional control of the fan’s saved quiet-hours schedule. We found no existing verified plugin specifically supporting these fans; please advise if there is overlap the review should address.

The Settings GUI requires each fan’s own Bluetooth address and six- or eight-digit PIN. Empty/unusable configuration does not load the Bluetooth driver or scan. There is no plugin install/postinstall script, no tracking/cloud API and no TTY prompt. Runtime state uses Homebridge accessory context. Bluetooth access is the normal host prerequisite; developer diagnostic commands are not installation requirements.

Controls authenticate before operation and confirm the fan’s response. Transient communication failures are caught and retried, with stale data or failed commands reported as HomeKit communication errors. Unsupported ambient temperature, humidity and light tiles have been removed. Tests cover authentication failure, malformed telemetry, timeouts, shutdown and pending-request recovery.

Physical control checks used two Vent-Axia Svara fans (firmware 02.08 with six-digit PIN and 02.10 with eight-digit PIN). Boost, Pause and cancellation were exercised. The owner additionally observed Wetroom Boost return to automatic operation; elapsed duration was not measured. We do not claim universal firmware compatibility, exact Siri recognition or uninterrupted long-term Bluetooth reliability.

The public npm tarball was downloaded and matched the checked artifact (SHA-256 99a2d42b4fac5e3019159c7b28e86082e4f5a375733ec3d0f90acb19c40f0edc). The default npm page shows the updated 2.5 guide and requested homepage. No verified badge is displayed; verification remains subject to your review.

Activity

  1. bwp91
    added
    request-verification
    on Oct 28, 2026

  2. bwp91 commented on Oct 28, 2026

    @bwp91
    bwp91
    on Oct 28, 2026
    Contributor

    /check

  3. github-actions
    added
    pendingthe label given to a new verification/icon request
    on Oct 28, 2026

  4. github-actions commented on Oct 28, 2026

    @github-actions
    github-actionsBot
    on Oct 28, 2026 – with 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.4.0
    • Package JSON: initializer function found
    • NPM Package: has not been deprecated
    • GitHub Repo: version in package.json (v2.5.1) matches NPM version (v2.5.1)
    • 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: minimal required - plugin should start with minimal required configuration
    • 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 v2.5.1 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.

  5. github-actions
    added
    awaiting-final-review
    and removed
    pendingthe label given to a new verification/icon request
    on Oct 28, 2026
  6. bwp91
    added a commit that references this issue on Oct 28, 2026

    verify: homebridge-pax-calima

    97471fd
  7. bwp91
    added
    verifieduse when a plugin meets the criteria - adds the verified badge text
    on Oct 28, 2026

  8. github-actions commented on Oct 28, 2026

    @github-actions
    github-actionsBot
    on Oct 28, 2026 – with 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. github-actions
    removed
    awaiting-final-review
    on Oct 28, 2026

  10. bwp91 commented on Oct 28, 2026

    @bwp91
    bwp91
    on Oct 28, 2026
    Contributor

    Hi @KernowekConsulting, thanks for submitting SvaraHome. Your request had lost its labels, so the automated checks never ran on it. I've added them, and the checks passed on 2.5.1. To answer your question: there's no overlap with an existing verified plugin, as none of them support the Pax Calima or Vent-Axia Svara fans.

    It's now verified, I've added your icon (it should start showing in the Homebridge UI within the hour), and I've listed it on the Bluetooth Plugins wiki page.

    One small request: only the 2.5.x versions have GitHub releases. Could you publish a release with notes for each new version from now on? Those notes are shown in the Homebridge UI when people update the plugin. Thanks for contributing to Homebridge!

  11. bwp91
    closed this as completedon Oct 28, 2026
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