Wondering what’s next for npm?Check out our public roadmap! »

    homebridge-verisure

    1.14.0 • Public • Published

    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": "your@email.com",
        "password": "yourT0p5ecre7Passw0rd",
        "token": "vid=topSecretToken",
        "alarmCode": "0000",
        "doorCode": "000000",
        "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.
    • 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 password in your config and will need to be renewed yearly.

    $ npx verisure
    ✔ What is your login email? · foo@bar.com
    ✔ What is your password? · ********************
    
     One-time code sent.
    
    ✔ What is your one time code? · FAKE12
    
     Your config is ready.
    
    {
      "platform": "verisure",
      "name": "Verisure",
      "email": "foo@bar.com",
      "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

    Install

    npm i homebridge-verisure

    DownloadsWeekly Downloads

    32

    Version

    1.14.0

    License

    MIT

    Unpacked Size

    29 kB

    Total Files

    18

    Last publish

    Collaborators

    • avatar