https://github.com/Danielhiversen/pySwitchbot

Filip Jaksic 837c3f3134 Add usage example for WoCurtain (Curtain 3) (#313) 2 days ago
.github e11bce8b91 chore(ci): bump codecov/codecov-action from 5.3.1 to 5.4.0 in the github-actions group (#307) 3 weeks ago
scripts 93ecb3aabd fix: drop python 3.10 support since it does not have StrEnum (#242) 9 months ago
switchbot 98c1311512 Add light level to ambient luminance conversion for Hub2 Illuminate entity (#290) 3 days ago
tests 98c1311512 Add light level to ambient luminance conversion for Hub2 Illuminate entity (#290) 3 days ago
.gitignore 3175309f58 Fix issue with SB password issue and Temp issue. (#28) 3 years ago
.isort.cfg 93ecb3aabd fix: drop python 3.10 support since it does not have StrEnum (#242) 9 months ago
.pre-commit-config.yaml 6e977fde6b chore(pre-commit.ci): pre-commit autoupdate (#314) 3 days ago
.travis.yml 93ecb3aabd fix: drop python 3.10 support since it does not have StrEnum (#242) 9 months ago
LICENSE 555bc08aa5 Initial commit 6 years ago
MANIFEST.in a6068bbc4d Add MANIFEST.in (#19) 4 years ago
README.md 837c3f3134 Add usage example for WoCurtain (Curtain 3) (#313) 2 days ago
pyproject.toml d8bf41dd7b chore: add additional ruff config (#302) 1 month ago
requirements.txt 067989c8c1 Fix lock encryption key retrieval (#236) 10 months ago
requirements_dev.txt 067989c8c1 Fix lock encryption key retrieval (#236) 10 months ago
setup.py 8698281f25 Release 0.58.0 3 days ago

README.md

pySwitchbot Build Status

Library to control Switchbot IoT devices https://www.switch-bot.com/bot

Obtaining encryption key for Switchbot Locks

Using the script scripts/get_encryption_key.py you can manually obtain locks encryption key.

Usage:

$ python3 get_encryption_key.py MAC USERNAME
Key ID: xx
Encryption key: xxxxxxxxxxxxxxxx

Where MAC is MAC address of the lock and USERNAME is your SwitchBot account username, after that script will ask for your password. If authentication succeeds then script should output your key id and encryption key.

Examples:

WoLock

import asyncio
from switchbot.discovery import GetSwitchbotDevices
from switchbot.devices import lock


async def main():
    wolock = await GetSwitchbotDevices().get_locks()
    await lock.SwitchbotLock(wolock['32C0F607-18B8-xxxx-xxxx-xxxxxxxxxx'].device, "key-id", "encryption-key").get_lock_status()


asyncio.run(main())

WoCurtain (Curtain 3)

import asyncio
from pprint import pprint
from switchbot import GetSwitchbotDevices
from switchbot.devices import curtain


async def main():
    # get the BLE advertisement data of all switchbot devices in the vicinity
    advertisement_data = await GetSwitchbotDevices().discover()

    for i in advertisement_data.values():
        pprint(i)
        print()  # print newline so that devices' data is separated visually

    # find your device's BLE address by inspecting the above printed debug logs, example below
    ble_address = "9915077C-C6FD-5FF6-27D3-45087898790B"
    # get the BLE device (via its address) and construct a curtain device
    ble_device = advertisement_data[ble_address].device
    curtain_device = curtain.SwitchbotCurtain(ble_device, reverse_mode=False)

    pprint(await curtain_device.get_device_data())
    pprint(await curtain_device.get_basic_info())
    await curtain_device.set_position(100)


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