- Piano with MIDI or USB output
- MIDI to USB interface (if your piano doesn't have USB output)
Amazon US | Aliexpress(cheap midi interfaces might not work as intended, I recommend hardware from more known brands. I personally use iConnectivity mio Amazon US ) - Raspberry Pi Zero WH Amazon US | Aliexpress | Aliexpress #2
- MicroSD card (16 GB is more than enough) Amazon US | Aliexpress
- USB OTG Amazon US | Aliexpress
- WS2812B LED Strip (at least 1.5m with 144 diodes/meter) Amazon US | Aliexpress
- Power Supply (5V 6A is enough to light 172 LEDs @50% power) Amazon US | Aliexpress
- DC 5.5x2.5mm socket with quick connection Amazon US | Aliexpress
- 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)
- 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)
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.
There are two ways, you can use preconfigured system image or install everything manually.
- 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.
Wi-Fi setup is optional, but will be needed if you wish to use the web interface
There is no point to reinvent the wheel again, here is a nice tutorial (do only the hardware part)
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
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
1. Sevilla's Soft MIDI USB-USB device This is, in my opinion, the best way to make connection between RPi and PC. It works with any device that support MIDI over USB, offers the lowest latency and no lost packets. The only downside is that it cost €39.00 (~48 USD) + shipping. You connect your Piano and PC to USB HUB connected to RPi and that's it, everything just works. Link to store
2. RTP MIDI (MIDI by ethernet) For this method you need to use some software on your Synthesia's device and both devices must be connected to the same local network.
-
Windows: rtpMIDI by Tobias Erichsen | tutorial
-
MAC: Tutorial
-
Android Midi Connector Free or touchdaw
Default port is 5004.
3. Bluetooth This method is not recommended due to problems with establishing the first connection, especially on devices other than those with Windows 10. If you still want to try, follow this link for instructions.
You have to enable light support in Synthesia by setting "Key Light" option to "Finger-based channel". In Visualizer settings you have to change "input" to either RPI Bluetooth (for bluetooth connection), rtpmidi raspberrypi (for RTP connections) or MIDI USB-USB (for cable connection). After that when learning new song next-to-play keys will be illuminated in corresponding colors, blue for left hand and green for right hand.
If you are getting mixed colors, meaning that leds are lighting up with your predefined and next-to-play colors at the same time, you can use "Skipped notes" option in Visualizer to disable one of them.
The Visualizer supports learning to play MIDI files without the need of Synthesia or additional external devices.
For practicing, the following 3 modes can be used:
- Melody: The song will wait for you to hit the correct notes. Take your time and try to avoid mistakes. Holding notes to their full duration is also important, otherwise you might develop muscle memory with the mistakes included.
- Rhythm: Adjust the speed using
Set tempooption until you can play without mistakes. Play as fast as you can comfortably. Work your way up to100%speed. Practice theMelodyfirst to make this step easier. - Listen: In this mode the song will play in listen only mode at the
Set tempospeed.
Different combinations of practicing modes be realized using the Hands and Mute Hand options. To practice only a section of the song, adjust the Start point and the End point values.
Recommended way of practicing is by following the song music sheet (see below how to print the music sheet from a midi file), while the Visualizer indicates the notes to press on the piano.
- Generating music sheet: To generate a printable music sheet from a MIDI file use the Midi Sheet Music app. The app already contains a library of MIDI files that can be played.
- Editing MIDI files: To visualize and edit MIDI files use the MidiEditor. Only type 1 of midi files have been tested. Other types of midi files might need to be adjusted in order to work with the Visualizer.
- Uploading MIDI files: Two ways are proposed here to upload MIDI files to Raspberry Pi Zero
- From PC: WinSCP
- From Smartphone: RaspController
In case of upload errors, use Putty to change the access permissions for the Songs folder:
cd /home/Piano-LED-Visualizer/
sudo chmod a+rwxX -R Songs/
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.
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 webinterface.
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 (for example: 192.168.1.10). 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?
-
A - From the Visualiser menu
Other Settings > Update visualizer > Confirm. After the update, a reboot is required. Warning: The update will revert all customizations to the default values! -
B - Connect to your console using SSH and type:
cd /home/Piano-LED-Visualizer
and then
git pull origin master
If for some reasons it does not work try to remove whole project and clone it again.
cd /home
sudo rm -rf Piano-LED-Visualizer
sudo git clone https://github.com/onlaj/Piano-LED-Visualizer
In the visualizer menu you can find setting called "Sequences". It allows you to change led properties while playing using third key on Waveshare hat or your piano pedals. You can edit or create new sequences by editing "sequences.xml" file. The "control_number" defines which pedal is used to go to the next step.
| Control number | Pedal name |
|---|---|
| 64 | Damper Pedal (Sustain/Hold) On/Off |
| 65 | Portamento On/Off |
| 66 | Sostenuto On/Off |
| 67 | Soft Pedal On/Off |
The "next_step" value decides if next step is activated when you press or release the pedal. For example if you want to change settings after fully pressing Sostenuto pedal you should write it like:
<control_number>66</control_number>
<next_step>126</next_step>
127 is the maximum value when pedal is fully pressed, so you are saying to script to change settings when value is bigger than 126. This is how it should look when you want to change settings when fully releasing pedal.
<control_number>66</control_number>
<next_step>-1</next_step>
(-) before the number means that next step will be activated when pedal value is below 1.
You can also use sequences as a way to save your presets under custom names.
