Skip to main content

This is a fork of the below with fixes and performance improvements.

This is a Python3 fork of the original module for controlling Kwikset Kevo locks written by CSeelye.

Per Cseelye:

Kwikset does not provide an official API for their Kevo locks; I reverse engineered this module from the mykevo.com web app.

To use this module you will need to have a Kevo Plus installed and a registered account on mykevo.com. You will need your mykevo.com credentials to use this module.

This module is published to pypi so you can install it simply via pip install pykevocontrol

Usage

The Kevo.GetLocks() function will attempt to scrape the mykevo.com web site to find your locks; as of this writing it can find all of your locks, but scraping the HTML might break at any time if Kwikset changes the website. This is broken as of 9 Sep 2019 due to recent CAPTCHA changes on the Kevo web site, however the KevoLock.FromLockID() method still works.

from pykevoplus import Kevo
locks = Kevo.GetLocks("username@email.com", "password123")
for lock in locks:
    print(repr(lock))

Output:

KevoLock(name=Front Door, id=cca7cd1d-c1d5-43ce-a087-c73b974b3529, state=Locked)
KevoLock(name=Back Door, id=c60130cd-8139-4688-8ba3-199276a65ad6, state=Locked)

A better way is to explicitly instantiate a KevoLock object using the UUID of the lock. You can get the lock IDs manually by logging into mykevo.com, click Details for the lock, click Settings, the lock ID is on the right.

from pykevoplus import KevoLock
lock = KevoLock.FromLockID("cca7cd1d-c1d5-43ce-a087-c73b974b3529", "username@email.com", "password123")

Locking and Unlocking

from pykevoplus import KevoLock
lock = KevoLock.FromLockID(lock_id, username, password)
lock.Unlock()
print(lock.GetBoltState())
lock.Lock()
print(lock.GetBoltState())

Output:

Unlocked
Locked

Multiple operations in the same session

The KevoLockSession context manager allows you to perform multiple operations on a lock with a single auth session

from pykevoplus import KevoLock, KevoLockSession
lock = KevoLock.FromLockID(lock_id, username, password)
with KevoLockSession(lock):
    lock.Unlock()
    lock.Lock()

Known Issues

  • Error handling is extremely basic and needs much more work. Communication errors as well as lock bolt errors need to be addressed

  • Alpha support for Python3

Metadata

Release files for pykevoplusnew 3.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pykevoplusnew 3.0.0
File Size Uploaded Provenance Actions
pykevoplusnew-3.0.0.tar.gz 5.7 kB Without provenance Details for pykevoplusnew-3.0.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for pykevoplusnew 3.0.0
File Interpreter ABI Platform Actions
pykevoplusnew-3.0.0-py3-none-any.whl Python 3 none any Details for pykevoplusnew-3.0.0-py3-none-any.whl

Total release size: 11.8 kB

Release files / pykevoplusnew-3.0.0.tar.gz

Download URL pykevoplusnew-3.0.0.tar.gz
Size 5.7 kB
Tags Source
SHA-256 checksum
How to use checksums
522fbcc57e3ffd6759937aaa20afbdc8a8519980c69942d3e3a31b032227e0da
BLAKE2b-256 checksum
How to use checksums
e6173efef290633c60cd51acbb7d0b826e9991dde4ff49dbad16736029219b9b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.1 CPython/3.9.11

Release files / pykevoplusnew-3.0.0-py3-none-any.whl

Download URL pykevoplusnew-3.0.0-py3-none-any.whl
Size 6.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
46424d39185bd9e59857cc5b1fd386fb21ba68ff1048698b6f824440595e52d7
BLAKE2b-256 checksum
How to use checksums
5faa8150f965c445b6f924b13f1a7b246c107f6b2dca8c764712200872ed00f4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.1 CPython/3.9.11

Security for pykevoplusnew 3.0.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

3.0.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page