Programmable control of Philips Hue lights using MIDI
- Python 3.6+
- Supports macOS. Should work on Linux, but not tested yet. Windows TBD.
mbedtls 2.x
package must be installed and linked on your system- macOS:
brew install mbedtls@2
- debian/ubuntu:
sudo apt-get install libmbedtls-dev
- windows/other: good luck!
- macOS:
This package is not yet registered with PyPI so you will need to install it from source.
For development purposes, clone the repo and run bin/setup-dev
.
You can also try installing with pip
but currently this is not a good idea since
the package isn't generally useful without code customizations for your own setup.
pip install https://github.com/ndonald2/midi-hue.git
The package provides a CLI entry point: midi-hue
Run midi-hue --help
to print usage details.
Bridge discovery is automatic and chooses the first bridge in your local network if you have
more than one. Upon running the first time you should be prompted to press the physical button
on your Hue bridge and run again. This is necessary for the auth process to verify you have
physical access to the bridge. After that, the auth credentials will be persisted to ~/.midihue
by default, but this can be overridden with a CLI flag (TODO: support environment variables).
You will need at least one Entertainment Area setup on your Hue network, which can be done with the Hue mobile app(s). You will also need at least one MIDI input device on your computer.
src/cli.py