A python module for reading and changing status of verisure devices through verisure app API. Compatible with both Python2 (2.6+) and Python3.
This software is not affiliated with Verisure Holding AB and the developers take no legal responsibility for the functionality or security of your Verisure Alarms and devices.
1.8.1 Support MFA for python 2
1.8.0 Support for multi factor authentication
1.7.3 Raise error on login failure on both hosts
1.7.2 Handle non-existing or corrupt cookie file
1.7.1 Fix content type for post
1.7.0 New login URL
1.6.1 Add LICENSE in MANIFESt.in
1.6.0 Add get firmware status
1.5.4 ResponseError should not load response text as JSON
1.5.3 History filter fixed
1.5.2 String formatting in urls.imagecapture fixed
1.5.1 Update requests dependency to 2.20.0
1.5.0 Added support for Panasonic HeatPumps
1.4.3 Update eventlog URL
1.4.2 Session context manager
1.4.1 Add cookie cache for increased speed and to avoid having the password stored on disk
1.4.0 Add test ethernet command
1.3.8 Fix vacation mode URL
1.3.7 Urlencode username
1.3.6 Download image fixed
1.3.5 Fix issue with encoding of credentials
1.3.4 Fix issue with encoding in ResponseError
1.3.3 Switch between known sub domains
1.3.2 Update base url
1.3.1 Add LOCK and UNLOCK as filter options for event log
1.3.0 Added command for door/window status
1.2.0 CLI output as json
1.1.2 Change base host
1.1.1 Prettier printing of response error for command line usage
1.1.0 Support vacation mode
1.0.0 Move to app-API, major changes
pip install vsure
or
pip install git+https://github.com/persandstrom/python-verisure.git
usage: verisure.py [-h] [-i INSTALLATION] [-c COOKIE]
username password
username password {installations,overview,armstate,set,climate,eventlog,capture,imageseries,getimage,vacationmode,door_window,test_ethernet,firmware_status,mfa} ...
Read or change status of verisure devices
positional arguments:
username MyPages username
password MyPages password
{installations,overview,armstate,set,climate,eventlog,capture,imageseries,getimage,vacationmode,door_window,test_ethernet,firmware_status,mfa}
commands
installations Get information about installations
overview Read status of one or many device types
armstate Get arm state
set Set status of a device
climate get climate history
eventlog Get event log
capture Capture image
imageseries Get image series
getimage Download image
vacationmode Get vacation mode info
door_window Get door/window status
test_ethernet Update ethernet status
firmware_status Get firmware status
mfa Create new MFA token
optional arguments:
-h, --help show this help message and exit
-i INSTALLATION, --installation INSTALLATION
Installation number
-c COOKIE, --cookie COOKIE
File to store cookie in
By default multifactor authentication is enabled, and you have two options for authentication.
- Disabled MFA at mypages.verisure.com, this would allow for regular username and password authentication.
- Create a MFA token, which will be stored in your cookie file.
To create a token using command line:
vsure user@example.com mypassword mfa
You will be promted to enter the code that is sent to your registerd phone, and if this is a trusted device or not.
An example how the same thing is done programatically:
import verisure
session = verisure.Session('user@example.com', 'mypassword')
session.login_mfa()
code = input("Enter verification code: ")
trusted_device = input("Is this a trusted device [y/n]? ")
session.mfa_validate(code, trusted_device.lower() in ['y', 'yes'])
vsure user@example.com mypassword armstate
output:
{
"name": "Alex Poe",
"cid": "12345678",
"state": true,
"changedVia": "CODE",
"date": "2017-03-11T21:04:40.000Z",
"statusType": "ARMED_HOME"
}
vsure user@example.com mypassword overview
vsure user@example.com mypassword overview doorLockStatusList
vsure user@example.com mypassword set alarm 1234 DISARMED
vsure user@example.com mypassword set lock 123456 '6EA1 A422' unlock
vsure user@example.com mypassword set smartplug '5AC2 4LXH' on
vsure user@example.com mypassword eventlog -f ARM DISARM
import verisure
session = verisure.Session('user@example.com', 'mypassword')
session.login()
armstate = session.get_arm_state()
session.logout()
print(armstate["statusType"])
import verisure
session = verisure.Session('user@example.com', 'mypassword')
session.login()
session.set_arm_state('1234', 'ARMED_HOME')
session.logout()
import verisure
session = verisure.Session('user@example.com', 'mypassword')
session.login()
session.set_smartplug_state('1A2B 3C4D', True)
session.logout()
import verisure
session = verisure.Session('user@example.com', 'mypassword')
session.login()
overview = session.get_overview()
session.logout()
import verisure
session = verisure.Session('user@example.com', 'mypassword')
session.login()
events = session.get_history(('ARM', 'DISARM'))
session.logout()