Giter Club home page Giter Club logo

homebridge-verisure's Introduction

homebridge-verisure

Greenkeeper badge

GitHub Actions badge

This is a plugin for Homebridge. It's an implementation for your Verisure installation and exposes the following devices:

  • Security alarm
  • Climate sensor
  • Magnetic contact
  • Night Control
  • Siren
  • SmartLock
  • SmartPlug
  • Smoke detector
  • Vibration detector

Protect linked devices & accounts

If configured, this plugin will expose your security system and door lock. Please protect you installation from unauthorised access:

  1. Generate a unique pin for your config. Never, ever use the default one.
  2. Lock all devices with access to your installation when not in use.
  3. Remove access from users that no longer need it.
  4. Keep your devices up to date.

Installation

npm install -g homebridge-verisure

Now you can update your configuration file to enable the plugin, see sample snippet below.

Configuration

As part of your configuration, add an object with your Verisure credentials to your array (list) of enabled platform plugins. Example config:

"platforms": [
  {
    "platform" : "verisure",
    "name" : "Verisure",
    "email": "[email protected]",
    "password": "yourT0p5ecre7Passw0rd",
    "token": "vid=topSecretToken",
    "alarmCode": "0000",
    "doorCode": "000000",
    "installations": ["Alias"],
    "pollInterval": 60
  }
]
  • email Required string containing your Verisure account email address.
  • password Required string containing your Verisure account password. Not needed if you use a token.
  • token Required string for accounts with MFA enabled.
  • alarmCode Optional string containing your security system alarm code.
  • doorCode Optional string containing your door lock code.
  • installations Optional array for filtering installations based on Verisure alias. Defaults to []
  • pollInterval Optional integer containing poll interval in seconds. Defaults to 60.

Multi-factor authentication

[Verisure] MFA is enabled for user. Please see README.

In 2021 Verisure started enrolling MFA which requires you to obtain a long lived token. This token is used instead of a password in your config and will need to be renewed yearly. After installing the plugin, run npx verisure in your terminal and copy the output values into your config.

$ npx verisure
✔ What is your login email? · [email protected]
✔ What is your password? · ********************

 One-time code sent.

✔ What is your one-time code? · FAKE12

 Your config is ready.

{
  "platform": "verisure",
  "name": "Verisure",
  "email": "[email protected]",
  "token": "vid=topSecretToken"
}

Environment variables

For convenience, the following environment variables can be used instead of placing secrets in your config.json.

  • VERISURE_ALARM_CODE
  • VERISURE_DOOR_CODE
  • VERISURE_EMAIL
  • VERISURE_PASSWORD
  • VERISURE_TOKEN

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.