homebridge-shelly-ng

Homebridge plugin for Shelly, enabling HomeKit support for the next generation of Shelly devices.

For the first generation, see homebridge-shelly.

Supported devices

• Shelly Plus 1
• Shelly Plus 1 PM
• Shelly Plus 2 PM
• Shelly Plus I4
• Shelly Plus I4 DC
• Shelly Plus Plug US
• Shelly Pro 1
• Shelly Pro 1 PM
• Shelly Pro 2
• Shelly Pro 2 PM
• Shelly Pro 3
• Shelly Pro 4 PM

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-ng.
3. Add this plugin to the Homebridge config.json:

"platforms": [
  {
    "platform": "ShellyNG",
    "name": "Shelly NG"
  }
]

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.