Building a Christmas Music Light Show with a Raspberry Pi

Last Updated 10 December, 2015

A couple of years ago I really became interested in making a Christmas music light show using a Raspberry Pi. I've decided to put this post online to show you how to build the same show I built, and to talk about the challenges I had to overcome to get the show working. I'll also detail the hardware and software I used (links and downloads included) to make this show possible.

This particular project isn't as hard as you might think. Really, when you deconstruct how it works, the Raspberry Pi just plays a MIDI file and an MP3 file at the same time. Each of these audio files is playing the same song/melody in sequence. An application called Lightorgan, in a way, "listens" to the MIDI file as it is played and turns on the GPIO pins of your Raspberry Pi's in sequence with the song.

The Hardware

The Software

To really make sure you can get this project off the ground, I'm going to walk you through each step of the software setup process. This doesn't take a lot of time to setup, but it does have quite a few details. For the purposes of this tutorial, I'm going to assume that your are using the Raspbian Linux distro

Step 1: Install and Configure Timidity

You can install Timidity using the terminal command seen below. You'll also, after Timidity is installed, want to verify that you can hear audio back buy playing a MIDI file.

sudo apt-get install timidity

Once you have Timidity installed, you'll need to verify that it is listening on a midi port by using the aconnect -o command. You should see output that looks similar to this:

client 14: 'Midi Through' [type=kernel]
0 'Midi Through Port-0'
client 128: 'TiMidity' [type=user]
0 'TiMidity port 0 '
1 'TiMidity port 1 '
2 'TiMidity port 2 '
3 'TiMidity port 3 '

Try playing a midi file using the aplaymidi command. For example, aplaymidi --port 14 your*midi*file.mid.

If you midi playback stinks, as pointed out in a post by Chivalry Timbers, the default Timidity settings may be too high for the Raspberry Pi. To fix this, edit the /etc/timidity/timidity.cfg file and uncomment the following lines. Be sure to restart Timidity.

opt EFresamp=d      #disable resampling
opt EFvlpf=d #disable VLPF
opt EFreverb=d #disable reverb
opt EFchorus=d #disable chorus
opt EFdelay=d #disable delay
opt anti-alias=d #disable sample anti-aliasing
opt EWPVSETOZ #disable all Midi Controls
opt p32a #default to 32 voices with auto reduction
opt s32kHz #default sample frequency to 32kHz

Step 2: Install Gordon’s WiringPi Library

Download the latest software from the his repository, and follow the easy installation instructions for Gordon's WiringPi Library.

Step 3: Install Light Organ

At this point, you should download the source code for Chivalry Timbers' midi listening program, called Light Organ, at I've taken the liberty of cloning this over to GitHub where you can find the Light Organ Git repository. Download the code and configure it using this command.

sudo make && make install

Step 4: Run Light Organ

To "get your pins to listen to your midi file" you need to start Light Organ as root. You can do that using this command:

sudo ./lightorgan

You'll need to make sure you start Light Organ as root every time you intent to run your light show because it is the software that makes your pins react to the midi sequence. After Light Organ and the Wiring Pi library have been installed and started, you will be able to play a midi using the aplaymidi --port 14 yourMidiFile.mid command and see it hit your GPIO pins.

Connect the Relay Board to Your Raspberry Pi

To help you understand which pins should connect to the pins on the relay board, I've drawn up this simple pin diagram. Although it isn't a very official-looking diagram, it does give you a quick way to wire up the replay board. The numbers I've drawn reference the pins on the relay board, so pin number 2 on the realy board should be connected to the GND (ground) pin on the Raspberry Pi. If you need more help connecting the GPIO pins to the relay board, use the gpio readall command to give yourself a pin print-out.

Install Mpg123

Essentially, this system will use a midi file as part of the light control system, but the person who views/listens to this show will hear mp3 audio. To hear the mp3 audio, you'll want terminal softare to play it. You can download mpg123 to play your mp3 files with the following command:

sudo apt-get install mpg123

Download the Music and Python Script

I've written a little python script to play the midi and the mp3 at the same time. I found a few usable mp3/midi files at These files worked well for my project because the midi and the mp3 files are perfectly synchronized. As you'll see from my Git repo, I've chosen to play a few of these files with my project. You can download the python I wrote to handle the audio playback from the Git repo.

You'll find that the individual scripts I wrote to play a song are really simple. They really just synchronize the playing of an mp3 and a midi (the mp3 playback is started as a background process—notice the "&" at the end of the command) to be at the same time.

import os
import time

os.system("mpg123 -q carol-of-the-bells.mp3 &")
os.system("aplaymidi --port 14 carol-of-the-bells.mid")

The Final Result

Once you wire the relay board with power, connect your Raspberry Pi's GPIO pins to the relay board, and run the software provided in this blog post, you'll have your own working light show. Here's a video of what I would later turn into a 1500 light show!

Letters from Zac

Zac Vineyard

Director of Marketing Tech, NNU
Web Developer