Skip to main content

A minimal, unofficial implementation of a bluetooth client for casambi devices

Project description

PyPI Discord

A bluetooth based Python library for controlling Casambi networks

This library provides a currently alpha quality interface to Casambi-based lights over Bluetooth. The author is not associated with Casambi and the implementation is based on his own analysis of the protocol. This interface is not feature complete and was only tested with a very small network.

If you want to check out my (slow) progress in writing a integration for Home Assistant using this library you can take a look at https://github.com/lkempf/casambi-bt-hass/.

For a more mature solution using a gateway and the official Casambi API have a look at https://github.com/hellqvio86/aiocasambi.

Getting started

This library is available on PyPi:

pip install casambi-bt

Have a look at demo.py for a small example.

MacOS

MacOS does not expose the Bluetooth MAC address via their official API, if you're running this library on MacOS, it will use an undocumented IOBluetooth API to get the MAC Address. Without the real MAC address the integration with Casambi will not work. If you're running into problems fetching the MAC address on MacOS, try it on a Raspberry Pi.

Casambi network setup

If you have problems connecting to the network please check that your network is configured appropriately before creating an issue. The network I test this with uses the Evoultion firmware and is configured as follows (screenshots are for the iOS app but the Android app should look very similar):

Gateway settings Network settings Performance settings

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

casambi_bt_skk-0.4.0b2.post9.tar.gz (56.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

casambi_bt_skk-0.4.0b2.post9-py3-none-any.whl (42.5 kB view details)

Uploaded Python 3

File details

Details for the file casambi_bt_skk-0.4.0b2.post9.tar.gz.

File metadata

  • Download URL: casambi_bt_skk-0.4.0b2.post9.tar.gz
  • Upload date:
  • Size: 56.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.9

File hashes

Hashes for casambi_bt_skk-0.4.0b2.post9.tar.gz
Algorithm Hash digest
SHA256 02e87baac2752623dba7a130c4082e84586d13ab0ee5ecd745a48baa84070078
MD5 b0b4ec08145a81e3fd08ca3a064d14de
BLAKE2b-256 070b6b2e60406d7cf0b3fdff29bbdcf21361f904874f0f7145e79ce91ef75d9f

See more details on using hashes here.

File details

Details for the file casambi_bt_skk-0.4.0b2.post9-py3-none-any.whl.

File metadata

File hashes

Hashes for casambi_bt_skk-0.4.0b2.post9-py3-none-any.whl
Algorithm Hash digest
SHA256 5d7eeb2a866b3b15bd8b4a8e8977591ddd31f6ff3e4400de6c753f8f217a1a21
MD5 a8ea9245c9f5231c0f577f30e0dc75bb
BLAKE2b-256 4b664a382a18aa9f066cad6bc4d32f6748c3d4ffe9fd44eec662f9840c6bf339

See more details on using hashes here.

Supported by

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