name mode size
images 040000
.gitignore 100644 16B
LICENSE 100644 1.07kB
README.md 100644 3.36kB
hue-pad.service 100644 191B
hue_pad.py 100644 11.45kB
setup.py 100644 437B
README.md
# <p align="center"><img src="https://github.com/michael-lazar/hue-pad/blob/master/images/logo.png"></img></p> **Control Philips Hue Lights with a MIDI Pad Controller** This is a project that I created to control the lights in my office. It is designed to run on a Raspberry Pi 3, but it could also be installed on a laptop or any other device with wifi and USB. Video demonstration forthcoming. Controls -------- <dl> <dt>Knobs 1-8</dt> <dd>The knobs are used to control the brightness, hue, and color temperature of the lights.</dd> <dt>Pads 1-8</dt> <dd>Each pad is bound to a lighting <em>scene</em>, which defines the color & brightness of one or more lights. Tapping on a pad will activate its scene, and holding down a pad can be used to re-program a scene. </dl> See the [code](https://github.com/michael-lazar/hue-pad/blob/master/hue_pad.py) for more details. Components ---------- <table> <tr> <td><a href="http://www.akaipro.com/products/pad-controllers/lpd-8">Akai LPDD8 Laptop Pad Controller</a></td> <td align="center"><img src="https://github.com/michael-lazar/hue-pad/blob/master/images/lpd8.png" height=100></img></td> </tr> <tr> <td><a href="https://www.raspberrypi.org/products/raspberry-pi-3-model-b/">Raspberry Pi 3</a></td> <td align="center"><img src="https://github.com/michael-lazar/hue-pad/blob/master/images/raspberry_pi_3.png" height=100></img></td> </tr> <tr> <td><a href="http://www2.meethue.com/en-us/p/046677456214">Philips Hue Starter Kit</a></td> <td align="center"><img src="https://github.com/michael-lazar/hue-pad/blob/master/images/hue_light.png" height=100></img></td> </tr> </table> Installation ------------ Install the python script ```bash $ git clone https://github.com/michael-lazar/hue-pad.git $ cd hue-pad $ pip install . ``` Register a systemd service to launch at startup (optional) ```bash $ sudo cp hue-pad.service /etc/systemd/system $ sudo systemctl daemon-reload $ sudo systemctl enable hue-pad.service $ sudo systemctl start hue-pad.service ``` Usage ----- ``` Usage: hue-pad [OPTIONS] Control lighting effects with a MIDI Pad Controller. This script will watch for incoming MIDI events from an Akai LPD8 and use them to update lighting/color effects through a Philips Hue Bridge. Options: --debug / --no-debug Enable verbose logging. --hue-ip TEXT IP address of the Philips Hue Bridge. --db-file TEXT JSON file with lighting scene data. --light-ids TEXT Comma separated list of light IDs to control. [default: 1,2] --help Show this message and exit. ``` Scenes ------ Every pad on the LPD8 can be programmed to store a different lighting "scene". A lighting scene consists of brightness & color values for one or more lights. These scenes are stored in a persistent JSON document in the application's configuration directory. The Hue Bridge API has it's own concept of "scenes" and "groups" that are built into the firmware. However, accessing and storing these settings introduces a noticeable latency when using the MIDI controller. Therefore, this application only stores and sends commands to lights using their unique IDs. License ------- This project is distributed under the [MIT](https://github.com/michael-lazar/hue-pad/blob/master/LICENSE) license.