gomalock 2.1.0

A Python library for controlling Sesame smart locks over Bluetooth Low Energy.

gomalock

Sesame スマートロックを Bluetooth Low Energy で操作する Python ライブラリ。

主な機能

• Sesame 5 / Sesame 5 Pro / Sesame 5 USA の施錠、解錠、トグル操作
• Sesame 5 系の角度、バッテリー残量、オートロック設定の取得と変更
• Sesame Touch / Sesame Touch Pro / Sesame Touch 2 / Sesame Touch 2 Pro のバッテリー残量と登録済みカード、指紋、パスワード数の取得
• 周囲の Sesame デバイスのスキャン
• 新規 Sesame デバイスの登録
• 共有用 QR URL の作成
• 予期しない切断後の自動再接続

インストール

pip install gomalock

最新のソースからインストールする場合:

pip install git+https://github.com/meronepy/gomalock.git

クイックスタート

import asyncio

import gomalock

ADDRESS = "XX:XX:XX:XX:XX:XX"
SECRET_KEY = "0123456789abcdef0123456789abcdef"


async def main():
    async with gomalock.Sesame5(ADDRESS, secret_key=SECRET_KEY) as sesame5:
        await sesame5.unlock("gomalock")


if __name__ == "__main__":
    asyncio.run(main())

• ADDRESS は examples/discover.py で周囲の Sesame をスキャンして取得できます。
• SECRET_KEY は mochipon さん作成の QR Code Reader for SESAME でマネージャー権限以上の QR コードから抽出するか、SESAME Biz から取得できます。
• 詳しい使い方は examples と docs を参照してください。
• v1.1.2 以前から移行する場合は v2.0.0 移行ガイド を参照してください。

注意事項

• Raspberry Pi OS では Bluetooth がブロックされていることがあります。BleakBluetoothNotAvailableError が出る場合は、次を試してください。

sudo rfkill unblock bluetooth

• Bluetooth は距離が近いほど安定します。スキャンできない、接続に失敗する、操作だけ失敗する場合は、デバイスとの距離を近づけて試してください。
• Linux では BlueZ 5.82 (Raspberry Pi OS Trixie) 以降 が必要です。
• 履歴機能は公式アプリとの連携が難しいため実装していません。
• 非公式ライブラリです。動作保証はありません。自己責任で使用してください。

開発環境

• Windows 11 24H2, Python 3.13.3
• Raspberry Pi Zero 2W, Raspberry Pi OS Trixie (64bit), Python 3.13.3
• Sesame 5, 3.0-5-ad26ee
• Sesame 5 Pro, 3.0-7-ad26ee

対応機種

対応状況	機種
✅	Sesame 5
✅	Sesame 5 Pro
⚠️	Sesame 5 US (未検証)
❌	Sesame 4以前

対応状況	機種
✅	Sesame Touch
⚠️	Sesame Touch Pro (未検証)
⚠️	Sesame Touch 2 (未検証)
⚠️	Sesame Touch 2 Pro (未検証)
❌	Sesame Face
❌	Sesame Face Pro

対応環境

対応状況	OS
✅	Windows 11 version 22000 以降
✅	Linux with BlueZ 5.82 以降
⚠️	macOS 10.15 以降 (未検証)

Python 3.12 以降が必要です。