npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

homebridge-shelly-pp

v1.1.19

Published

Homebridge plugin for the next generation of Shelly devices

Downloads

206

Readme

homebridge-shelly-pp

npm-version

Homebridge plugin for Shelly, enabling HomeKit support for the next generation of Shelly devices. This Package is based on the shelly-ds9 fork of the package https://badgen.net/npm/v/homebridge-shelly-ng. To add support for switches that I require.

For the first generation, see homebridge-shelly.

Supported devices

Installation

Either install this plugin through Homebridge Config UI X or manually by following these instructions:

  1. Install Homebridge by following the instructions.
  2. Install this plugin by running npm install -g homebridge-shelly-pp.
  3. Add this plugin to the Homebridge config.json:
"platforms": [
  {
    "platform": "ShellyPP",
    "name": "Shelly PP"
  }
]

By default, devices will be discovered on your local network using mDNS and WebSockets will then be used to communicate with them.

Configuration

The following configuration options are available. Note that they are all optional.

{
  "devices": [
    {
      "id": "e.g. shellyplus1-abcdef123456",
      "name": "My Device",
      "exclude": false,
      "hostname": "e.g. 192.168.1.200",
      "password": "pa$$word",
      "switch:0": {
        "exclude": false,
        "type": "switch"
      },
      "switch:1": {
        "exclude": false,
        "type": "outlet"
      },
      "switch:2": {
        "exclude": false,
        "type": "switch"
      },
      "switch:3": {
        "exclude": false,
        "type": "switch"
      },
      "cover:0": {
        "exclude": false,
        "type": "windowCovering"
      }
    }
  ],
  "mdns": {
    "enable": true,
    "interface": "e.g. eth0 or 192.168.1.100"
  },
  "websocket": {
    "requestTimeout": 10,
    "pingInterval": 60,
    "reconnectInterval": [ 5, 10, 30, 60, 300, 600 ]
  }
}

See below for descriptions of each configuration option.

| Option | Description | | --- | --- | | devices | An array of one or more objects with options for specific devices. | | devices. id | The device ID. Here's how to find it. | | devices. name | The name of the device. This will be shown in the homebridge log and will be used as the default name when the device is added to HomeKit. Note though that setting this value after the device has been added will not change the name in HomeKit. If no name is specified, this plugin will use the device name set in the Shelly app, or the name of the device model. | | devices. exclude | Set this option to true to make this plugin ignore this device. | | devices. hostname | The IP address or hostname of the device. Set this value if your device can't be discovered automatically. | | devices. password | The password to use if authentication has been enabled for the device. | | devices. switch:0-3.exclude | Set this option to true to prevent the switch with the specified index number from being added to HomeKit. | | devices. switch:0-3.type | The type of accessory used to represent the switch with the specified index number. Available options are "outlet" and "switch" (default). | devices. cover:0.exclude | Set this option to true to prevent this cover from being added to HomeKit. | | devices. cover:0.type | Only available for devices in cover mode. The type of accessory used to represent the cover. Available options are "door", "window" (default) and "windowCovering". | mdns | Settings for the mDNS device discovery service. | | mdns. enable | Set this option to false to disable automatic device discovery using mDNS. | | mdns. interface | The network interface to use when sending and receiving mDNS packets. You probably don't need to use this setting unless you know what you're doing. If not specified, all available network interfaces will be used. | | websocket. requestTimeout | The time, in seconds, to wait for a response before a request is aborted. | | websocket. pingInterval | The interval, in seconds, at which ping requests should be made to verify that the connection is open. Set to 0 to disable. | | websocket. reconnectInterval | The interval, in seconds, at which a connection attempt should be made after a socket has been closed. If an array or a comma-separated list of numbers is specified, the first value will be used for the first connection attempt, the second value for the second attempt and so on. When the last value has been reached, it will be used for all subsequent connection attempts; unless the value is 0, in which case no more attempts will be made. Set to 0 to disable. |