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.

Please note this won't work on Mac OSX since it doesn't expose Bluetooth Mac addresses, which are needed to communicate with the Casambi APIs. Instead, 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 Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

casambi_bt-0.2.2-py3-none-any.whl (29.6 kB view details)

Uploaded Python 3

File details

Details for the file casambi_bt-0.2.2-py3-none-any.whl.

File metadata

  • Download URL: casambi_bt-0.2.2-py3-none-any.whl
  • Upload date:
  • Size: 29.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.6

File hashes

Hashes for casambi_bt-0.2.2-py3-none-any.whl
Algorithm Hash digest
SHA256 e6d2a2bb0a8aa67503e405d72f7f6935c0d1fbd7008c440fdb315bc0fc5e8793
MD5 ccac5368725b018ee8035f1cbaec7c64
BLAKE2b-256 647b6957c4c140c87df3e77b51e666c91628a4e3f5abc457e7cfcf7e856c9a31

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