Java C++ JavaScript PHP CSS HTML Other
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Heckenlights is the web-controllable christmas lights setup at

This repository carries a set of code modules to control christmas lights using MIDI commands. The particular modules are:

  1. Heckenlights Backend (Java/Spring Boot): Backend for controlling the program, accepting MIDI file submissions and providing the current playlist
  2. Heckenlights Frontend (HTML/PHP): HTML frontend to display the playlist and the the MIDI submission
  3. Heckenlights Messagebox (Java): Image Generator to generate images from the Twitter stream, current title and some advertising
  4. Heckenlights Messagebox Controller (Python): Controller of the messagebox which retrieves the Messagebox images and sends these to a RGB matrix display
  5. rpi-rgb-led-matrix (C++): Matrix display application to scroll PPM (PNM) images onto a Medium 16x32 RGB LED matrix panel (fork of

And one more thing: Heckenlights uses [] to switch lights on and off. Midi-relay is an own repository.

How it works

Heckenlights is a MIDI controllable christmas lights setup at Heckenpfad 14, Weinheim, Germany. In the beginning, I started just with some lights. The next year, I decided to add some sort of control. All available control systems are either very expensive or available to US only. Therefore I decided to add an ethernet controlled relay (ETHRLY-16) and a controller application midi-relay. midi-relay can be fed with MIDI files and uses the software sequencer to play MIDI files with redirecting/mapping all note output towards the ethernet relay. midi-relay runs on a Linux box (headless) controlling two ethernet relays having several chains of christmas light connected.

Next step was adding a Web-UI and a Matrix Display for live streaming of Heckenlights itself, uploading MIDI files and watching the playlist. heckenlights-backend manages all backend-related details like when to play, store and manage MIDI submissions within TokuMX. heckenlights-backend submits every item from the playlist to midi-relay and is the DJ in this case.

heckenlights-frontend is 'just' a HTML frontend using a small potion of PHP to communicate with heckenlights-backend over HTTP.

<img src="../master/images/Heckenlights-Messagebox.png?raw=true" width="200" style="margin: 5px"align="left"/> Last year, I noticed it would be also nice to know what is played. Watching Heckenlights play is amazing, but if you don't know the song it's sort of awkward. Here comes the heckenlights-messagebox: The Messagebox is a RaspberryPi with a Medium 16x32 RGB LED matrix panel connected. It runs two things: heckenlights-messagebox-controller and rpi-rgb-led-matrix. The first one pulls data from heckenlights-messagebox (PPM images containing Tweets of #Heckenlights, the current title and some details of rpi-rgb-led-matrix takes care of scrolling the PPM images onto the LED Matrix Display using GPIO.