Piano LED Visualizer

Join Discord

The Piano LED Visualizer is a project that enables you to connect an LED strip to your Raspberry Pi and enhance your piano playing with captivating visual effects. This repository provides detailed instructions on how to set up the LED strip, connect it to a digital piano, and synchronize the lighting with your playing. Additionally, it offers integration with external software such as Synthesia for an enhanced learning experience.

Features

Visual Effects: Acts as a sound visualizer, making your piano playing look cool with lights that react to your music.
Learning: Lights above the keys show you which ones to play, helping you learn piano.
MIDI Integration: Supports external software like Synthesia for lighting next-to-play keys.
Customizable Lights: You can change the colors and brightness of the lights to fit your style.
Record and Play: Record your piano songs, download them or play directly from Visualizer.
MIDI Files: Load MIDI files to see which keys to play, making it easy to learn new songs.
Light Sequences: Create sequences to switch between different light settings during your performance.
Web Control: Use a simple web interface to set up and control the lights.
Optional Hat Extension: There's an extra hat with buttons and a screen for easier control, making it a standalone device.
Cool Animations: Enjoy light animations to add atmosphere to your music.

Detailed feature showcase with images

What you need:

Piano with MIDI or USB output
MIDI to USB interface (if your piano doesn't have USB output) Amazon US | Amazon FR | Aliexpress (cheap midi interfaces might not work as intended, I recommend hardware from more known brands. I personally use iConnectivity mio
Raspberry Pi Zero WH Amazon US | Amazon FR | Aliexpress | Aliexpress #2
MicroSD card (16 GB is more than enough) Amazon US | Amazon FR) | Aliexpress
USB OTG Amazon US | Amazon FR | Aliexpress
WS2812B LED Strip (at least 1.5m with 144 diodes/meter) Amazon US | Amazon FR | Aliexpress
Power Supply (5V 6A is enough to light 172 LEDs @50% power) Amazon US | Amazon FR | Aliexpress

Make sure the power supply is 5V (5 Volt). using power supply with more Volt WILL damage both LED strip and Raspberry Pi.
DC 5.5x2.5mm socket with quick connection Amazon US | Aliexpress (if you bought power supply on amazon it might be already included)
Some wires Amazon US | Aliexpress

Not required but worth having, to make everything look neat:

Custom 3d printed case (I attached STL file with modified 3d model, there is additional space and holes for power socket and wires, here is original model). Optionally you can use models without a holes for screen, hdmi and sd port, provided by fermaton
Nylon standoffs M2.5 10mm Amazon US | Aliexpress
Screws M2.5 10mm Amazon US | Aliexpress
Waveshare LCD TFT 1,44'' 128x128px Amazon US | Aliexpress
Braid for cables Amazon US | Aliexpress
Heat shrink bands Amazon US | Aliexpress
Aluminium LED Profile with diffuser (highly recommend to search for the right one in local shops) pic#1 pic#2 Alternative made of silica gel: Aliexpress (choose T0515 for 12mm 2 meters, credits to vzoltan for finding this)
Double side tape to stick everything on the piano
Windows 10 laptop/tablet with bluetooth to run Synthesia
magnetic or mechanical switch to detect if the keyboard cover is opened or closed, if your piano has one (see Instructions)

For items like screws, standoffs, and wires, look at local hardware stores to avoid buying in bulk.

Total cost (excluding piano and tablet) should be 75-100 USD Disclosure: All of the links above are affiliate links, which means that without additional costs for you, I will earn a commission if you make a purchase by clicking through it.

Software preparations

There are two ways, you can use preconfigured system image or install everything manually.

1. System image

Download the latest zip file from releases.
Unzip the file.
Use program like Win32 Disk Imager or Etcher to save system image to your SD card (4GB is a minimum).

If you don't need to connect your RPi to Wi-Fi you can eject SD card from your PC and put it in Raspberry Pi. After 3-8 minutes (depending on how fast your SD card is) you should see Visualizer menu on RPi screen.

For version 1.5 and above:

The Raspberry Pi sets up a Wi-Fi hotspot named 'PianoLEDVisualizer' with the password 'visualizer'. Once connected, open your browser and go to "pianoledvisualizer.local" to access the web interface. Use the "Network" tab there to link the Raspberry Pi to your regular network.

You can also connect Raspberry Pi to your network manually

2. Manual installation

Instructions

Connecting LED Strip to Raspberry Pi and enabling SPI

There is no point to reinvent the wheel again, here is a nice tutorial (do only the hardware part). Double check how your LED strip is wired. Most strips use G-D-V (ground, data, voltage), however in the wiring diagram shown in the tutorial the voltage and data lines are swapped. Connecting voltage directly to your data pin might seriously damage or kill your Raspberry!

Optionally, you can connect a switch to BCM pin 12 and GND. Attach the switch to the key cover, if available. When it is closed, the animations are automatically switched off.

If you are wondering how to connect wires to RPI if screen hat is taking all pins here is a picture of how I did it. There should be a gap between RPI and screen so you can solder your wires or just wrap cables around the pins and separate them with heat shrink bands.

After connecting all cables as described above everything should fit nicely to case. Scroll down to see some photos of the setup I made If you don't have a 3d printer, try to find some company or private person who will print it for you. I paid 12USD for my print. RPICaseModel.stl

Web interface

The visualizer comes with a web interface with which you can control the colors of the LED strip, change port settings, run animations of the strip, control sequences and manage midi files, including downloading, uploading, renaming, deleting, and playing. To connect to the web interface, type the local address of your raspberry pi in the browser, for example http:/192.168.1.10 Both devices must be connected to the same network. By default, web interface works on port 80, but if needed it can be changed with the script's argument --port

sudo python3 /home/Piano-LED-Visualizer/visualizer.py --port 5000

Although in my tests I did not notice any deterioration in performance, if necessary, you can disable the web interface with the --webinterface parameter

sudo python3 /home/Piano-LED-Visualizer/visualizer.py --webinterface false

FAQ

Q - Can I use Raspberry Pi 1/2/3/4 instead of Zero?

In theory, yes. In practice many users reported problems with huge delay between key presses and lights reacting to it on Raspberrys other than Zero.

Q - What about Raspberry Pi Zero without Wi-Fi and bluetooth?

If you are going only for the visuals and do not plan to use it with Synthesia you can save some bucks and buy cheaper, non-WH version of Zero. Notice, that you won't be able to use web interface

Q - Can I use other screens or no screen at all?

Currently, the only other supported screen is Waveshare LCD TFT 1,3". As for no screen, you can instead use web interface.

Q - Does the color of LED strip PCB matter?

No, it's only visuals.

Q - Can I use other led strip?

Only WS281X led strips are supported

Q - Do I need power supply for LED strip?

RPi alone should be fine powering up to 10 LEDs at the same time, although I do not recommend it.

Q - Do I need soldering skills to make it?

Users reported that LED strips bought on Amazon are shipped in one meter strips, in that case you would need to solder them. I bought mine on Aliexpress and it was 2 meters long strip in one piece. As for connecting wires to RPi, I just wrapped them around pins and tightened it with heat shrink bands.

Q - How do I access recorded files?

If you connected your RPi to Wi-Fi you can use SFTP or web interface to transfer files.

For web interface: Open internet browser on device connected to the same network and type RPi's local address pianoledvisualizer.local Then from the menu on the left choose "songs management" tab.

For SFTP: in any FTP program (like Filezilla) connect to your RPi local address (for example: sftp://192.168.1.10) and navigate to /home/Piano-LED-Visualizer/Songs.

Q - How do I update visualizer?