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

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

casambi_bt-0.2.3-py3-none-any.whl (30.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: casambi_bt-0.2.3-py3-none-any.whl
  • Upload date:
  • Size: 30.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.13.1

File hashes

Hashes for casambi_bt-0.2.3-py3-none-any.whl
Algorithm Hash digest
SHA256 6526dcb1deab77d993c6952e30eca5b45abe0d75b84d3abca18f1d6b3431e1d6
MD5 5fbf96d4531ef09c9665be5cc794679d
BLAKE2b-256 2896d7cdccdf7baa0516c7aebef93933cbcd33ae61b96d65157988aa1a9378f8

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