Homebridge-Vivint

Overview

This plugin allows Homekit to you to use your Vivint SmartHome products in Apple Homekit.

Homebridge-Vivint was written by a former Vivint employee, Tim Harper. This project is not officially endorsed, sponsored, or affiliated with Vivint SmartHome in any way.

Supported Items

Currently, the following items are supported:

• Locks
• Contact sensors
• Thermostat
• Motion sensors

Support for adding additional devices is relatively trivial. Please open a PR if you'd like to see more!

Configuration

Configuration of the plugin is simple. The Vivint plugin is a dynamic platform which caches the accessories registered.

{
  "platform": "Vivint",
  "username": "[email protected]",
  "password": "vivint-user-password",
  "apiLoginRefreshSecs": 1200,
}

A general recommendation: consider creating and using a new Vivint account named "Apple Home". This way, your Vivint logs will show "the front door was unlocked by Apple Home", etc.

Configuration options overview:

• username
• password
• apiLoginRefreshSecs - How often should Vivint Homebridge renew the session token? The token that Vivint provides when authenticating will expire. Also, when this renewal occurs, the plugin requests another snapshot. The event stream can sometimes fail to report device state appropriately and events can come out of order with the snapshot, or updates can be missed entirely. The occasional snapshot retrieval will auto-correct any such errors. Avoid setting this any more frequent that 10 minutes.
• motionDetectedOccupancySensorMins - Homebridge-vivint will create occupancy sensors for motion sensors that will stay active for X minutes after a motion event is detected. This value configures for how long that occupancy sensor will stay active if no further motion events are detected. Note: Vivint's reporting of motion events over the event stream can be a little inconsistent, at times. As a recommendation, don't plan on creating Homekit automations that respond to Vivint motion events.