Skip to main content

Unofficial library to control smart devices running Sesame OS2.

Project description

pysesameos2

Unofficial Python Library to communicate with SESAME products via Bluetooth.

PyPI PyPI - Python Version GitHub Workflow Status (branch) Documentation Status codecov PyPI - License

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.

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

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)

Uploaded Source

Built Distribution

pysesameos2-0.0.6-py3-none-any.whl (24.2 kB view details)

Uploaded Python 3

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

Hashes for pysesameos2-0.0.6.tar.gz
Algorithm Hash digest
SHA256 353999bec96f9ba8f7812969f8a5a25142761c3bfa9be5a66d9bd82a7642fba1
MD5 3a8320ebb69c5b23d4b02b78bc886ebf
BLAKE2b-256 4fef6e8492b007430c431029bdf9e14ab8bf318834ca084bb609a1a901e71478

See more details on using hashes here.

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

Hashes for pysesameos2-0.0.6-py3-none-any.whl
Algorithm Hash digest
SHA256 052a46ade49468acd243a54e7e88a4b16d7d3f2f1e6b184ddf2e470c8f65fea8
MD5 690ddfff59e0256e0e06ff2340d50176
BLAKE2b-256 51f0d30ca0790ac427a5d7dd38789d72c196f0ae5db5e8d484ad589b83f0fbcf

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page