Python library for interacting with a Vivint security and smart home system.
Project description
vivintpy
Python library for interacting with a Vivint security and smart home system.
This was built to support the Vivint integration in Home-Assistant but should work outside of it too. Currently, it can be utilized via HACS by adding the hacs-vivint custom repository.
Credit
This was inspired by the great work done by Mike Reibard to reverse engineer the Vivint Sky API and Ovidiu Stateina for the repository from which this is forked and expanded on.
Features
It currently has support for the following device types:
- alarm panels
- cameras
- door locks
- garage doors
- switches
- binary
- multilevel
- thermostats
- wireless sensors
- carbon monoxide
- door/window
- flood
- glass break
- motion
- smoke/fire
- etc
In addition, it integrates with PubNub to receive real-time updates for devices. This subscription stops receiving notifications around 15-20 minutes unless a call is made to the Vivint Sky API periodically. This might be related to the cookie expiration since it expires 20 minutes after the last API call was received. If another client connects, however, the notifications start to stream again for all currently connected clients.
Usage
See demo.py for a demonstration on how to use this library.
TODO:
- write a better readme
- write some documentation
- add advanced support for:
- thermostats
- add tests
Support Me
I'm not employed by Vivint, and provide this python package as-is.
If you don't already own a Vivint system, please consider using my referal code (kaf164) to get $50 off your bill (as well as a tip to me in appreciation)!
If you already own a Vivint system and still want to donate, consider buying me a coffee ☕ (or beer 🍺) instead by using the link below:
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for vivintpy-2023.3.9-py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 2f48e8644fa5cb939b2c77b1b8f37b13048580676b070cbd678eb8fe9b233092 |
|
| MD5 | c9a85290e596683e93b8106cb5aa4c6d |
|
| BLAKE2b-256 | 813c1ec1aa4904fd060ae51ce6a4a7659f6a3857f77073ee64377dbf1f4c402c |
