当前位置: 首页 > 软件库 > 其他开源 > 物联网 >

homebridge-nello

Homebridge plugin for the smart intercom nello.io.
授权协议 MIT License
开发语言 JavaScript
所属分类 其他开源、 物联网
软件类型 开源软件
地区 不详
投 递 者 东方震博
操作系统 跨平台
开源组织
适用人群 未知
 软件概览

homebridge-nello

This project is a homebridge plugin for the smart intercom nello.io. All your nello.io locks are dynamically added to HomeKit as lock accessories. If you want to learn more about the smart intercom nello one, please visit https://www.nello.io.

Configuration / Docs

Features

  • Door Lock
  • Motion Sensor
  • Video Doorbell
  • Configurable Switch to automatically open the door on ring

Disclaimer

Nello went bankrupt and was bought by Sclak. The public API was down for a long time after the announcement in October 2019 (though the app worked intermittently), but is back online as of August 2020. This plugin may stop working at any time due to this uncertainty. (See: #48)

Migration Guide from 0.5.x to 1.x.x

Look here: Release v1.0.0

Installation

It's recommended to create a new dedicated nello.io account in order to prevent duplicated notifications if you open the door over the Home app. It's also possible to use your own account with this plugin.

  1. Install the plugin via npm:

    npm install homebridge-nello -g
  2. Generate clientId & clientSecret

    IMPORTANT: Please visit https://auth.nello.io/admin/ and sign in with your username and password that you also use in the nello.io app. If you are using a dedicated user account for this plugin, make sure that you use the credentials of this account to generate a client ID.

    Fill in all required fields in the "Create API client" form (mark all "Allowed response type"s and "Allowed grant type"s)

  3. Add the basic configuration

    {
      "platforms": [
        {
          "platform" : "NelloPlatform",
          "name" : "nello.io",
          "auth": {
            "clientSecret": "<paste-client-secret-here>",
            "clientId": "<paste-client-id-here>"
          }
        }
      ]
    }
  4. This exposes ONLY the door lock. Look at the docs for more options to configure motion sensors, the video doorbell, a custom webhook server, automation helper switches, and configure reachability.

Optional: Installation of FFMPEG

You can install the default package or compile it yourself if you have a special case to fit.

sudo apt-get install ffmpeg

General information about ffmpeg can be found here https://github.com/KhaosT/homebridge-camera-ffmpeg/wiki)

Due to HomeKit limitations it's required to add the camera separately. Just tap on the plus button in the top right corner, choose "Add Accessory" and click on "Don't Have a Code or Can't Scan?". In the next view you should see the camera accessory. Tap it in order to add it to the Home app. The PIN is the same as of your HomeBridge instance.

You need to install ffmpeg if you want to see a picture in the Home app. Just take a look at last paragraph of the Installation part.

Implementation Details

This plugin uses the HTTP API of nello.io for the following features:

  • Nello Authentication: Retrieves a token using the specified client ID & secret
  • Nello Public API: see all methods in APIClient

Others

Security

  • All requests to the nello.io are made over HTTPS.
  • The client secret used by this plugin has to be specified in the config.json on the PC/Mac/Raspberry running homebridge. Please make sure that nobody can access this device within your local network without permission.
  • In the Apple Home app, a lock can be easily unlocked with a single tap on the icon. Please be careful not to open the door unintentionally.
  • The webhook uses a relay service which is hosted by @AlexanderBabel. You can find the source code of the service here: https://github.com/AlexanderBabel/nello-backend. You can override this and configure your own URL if you expose the right ports, look at the docs for more info.

Development

Linting

npm run lint / npm run format

Publishing

  • To bump the version and publish automatically, go to the bump-version workflow and trigger a new event by clicking Run workflow. You can enter major minor patch or an actual version like v0.0.1. This bumps the package.json version, creates a tag, updates the docs, pushes it back to master, and publishes to npm. (Source: bump-version.yml).
  • Now go to Releases where you will see a release already published for you. You should update the release notes here.

(Requires GitHub Action NPM_TOKEN secret to be set in the repo with publish rights).

 相关资料
  • Homebridge 是一个轻量级 NodeJS 服务器,它模拟 iOS HomeKit API,提供从 HomeKit 到“智能家居”设备制造商提供的各种第三方 API 的基本桥接。通过 Homebridge 的桥接,可以让 Siri 控制完全不支持 HomeKit 的设备。 此外 Homebridge 支持插件。

  • homebridge-vsx homebridge-vsx is a plugin made for homebridge,which allows switching on and off your Pioneer AV receiver. All AV receivers (VSX and SC),which work with the iControl AV5 App are support

  • homebridge-sesame Control and monitor your Sesame smart lock with HomeKit integration. Prerequisites Installation of Homebridge iOS 11 or later Sesame lock with enabled cloud integration Sesame Wifi A

  • homebridge-panasonictv A homebridge plugin for turning on and off your Panasonic Viera TV. The plugin also has experimental support for changing the volume and channel. These characteristics are not r

  • Quick Start | Contribute A Wake on Lan plugin for Homebridge Turn your PCs, laptops, servers and more on and off through Siri Quick Start To install the plugin, head over to the machine with Homebridg

  • Docker Homebridge This Alpine/Ubuntu Linux based Docker image allows you to run Nfarina's Homebridge on your home network which emulates the iOS HomeKit API. This is a multi-arch image and will also r

  • This Plugin is no longer being maintained. The ST platform removed all of the greatness that made it fun to develop for and I will not rewrite my years of code to adapt. I have moved to Hubitat and al

  • Homebridge myQ myQ garage door and other myQ-enabled device support for Homebridge. homebridge-myq is a Homebridge plugin that makes myQ-enabled devices available to Apple's HomeKit smart home platfor