Unofficial library to control smart devices running Sesame OS2.
Project description
pysesameos2
Unofficial Python Library to communicate with SESAME products via Bluetooth.
Introduction
This project aims to control smart devices running Sesame OS2 via Bluetooth. If you want to control them via the cloud service, please check pysesame3.
To be honest, this is my first time to use Bleak
which provides an asynchronous, cross-platform Bluetooth API. PRs are heavily welcome.
- Free software: MIT license
- Documentation: https://pysesameos2.readthedocs.io
Tested Environments
- macOS 10.15.7, Python 3.9.5
- Raspberry Pi Zero W (Raspbian GNU/Linux 10, Raspberry Pi reference 2021-05-07), Python 3.7.3
Supported devices
Features
- Scan all SESAME locks using BLE advertisements.
- Receive state changes (locked, handle position, etc.) that are actively reported from the device.
- Needless to say, locking and unlocking!
Consideration
- The results of
pysesameos2
are merely from reverse engineering of the official SDK. We have implemented just a small part of it, so you might run into some issues. Please do let me know if you find any problems! pysesameos2
only supports devices that have already been initially configured using the official app. That is,pysesameos2
cannot configure the locking position of your device.pysesameos2
does not have, and will not have, any functionality related to the operation history of locks. According to the document, your lock's operation history is not stored in the lock itself, but on the cloud service. I personally recommend you to bring a Wi-Fi module to get the operation history uploaded and retrive it by the API.
Usage
Please take a look at the example
directory.
Related Projects
Libraries
Name | Lang | Communication Method |
---|---|---|
pysesame | Python | Sesame API v1/v2 |
pysesame2 | Python | Sesame API v3 |
pysesame3 | Python | Web API, CognitoAuth (The official android SDK reverse-engineered) |
pysesameos2 | Python | Bluetooth |
Integrations
Name | Description | Communication Method |
---|---|---|
doorman | Control SESAME3 from Homebridge by MQTT | Web API |
Doorlock | iOS widget for Sesame 3 smart lock | Web API |
gopy-sesame3 | NFC (Felica) integration | Web API |
homebridge-open-sesame | Homebridge plugin for SESAME3 | Cognito integration |
homebridge-sesame-os2 | Homebridge Plugin for SESAME OS2 (SESAME3) | Web API |
sesame3-webhook | Send SESAME3 status to specified url. (HTTP Post) | CognitoAuth (based on pysesame3 ) |
Credits & Thanks
- A huge thank you to all at CANDY HOUSE and their crowdfunding contributors!
- Thanks to @Chabiichi-san for the offer to get my SESAME bot!
- Many thanks to bleak and pyzerproc.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
pysesameos2-0.0.6.tar.gz
(29.9 kB
view details)
Built Distribution
File details
Details for the file pysesameos2-0.0.6.tar.gz
.
File metadata
- Download URL: pysesameos2-0.0.6.tar.gz
- Upload date:
- Size: 29.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.1 CPython/3.9.13
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 353999bec96f9ba8f7812969f8a5a25142761c3bfa9be5a66d9bd82a7642fba1 |
|
MD5 | 3a8320ebb69c5b23d4b02b78bc886ebf |
|
BLAKE2b-256 | 4fef6e8492b007430c431029bdf9e14ab8bf318834ca084bb609a1a901e71478 |
Provenance
File details
Details for the file pysesameos2-0.0.6-py3-none-any.whl
.
File metadata
- Download URL: pysesameos2-0.0.6-py3-none-any.whl
- Upload date:
- Size: 24.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.1 CPython/3.9.13
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 052a46ade49468acd243a54e7e88a4b16d7d3f2f1e6b184ddf2e470c8f65fea8 |
|
MD5 | 690ddfff59e0256e0e06ff2340d50176 |
|
BLAKE2b-256 | 51f0d30ca0790ac427a5d7dd38789d72c196f0ae5db5e8d484ad589b83f0fbcf |