Piano MIDI Player · Support
How can we help?
Most answers are below. If yours is not, write to us: we read every message.
Frequently asked questions
How do I install the add-on?
In Blender, go to Edit › Preferences › Get Extensions and search for “Piano MIDI Player”. Or download the
.zip from our page, then Edit › Preferences › Add-ons, open the ⌄ menu and choose Install from Disk…. Leave the file zipped.Which Blender versions are supported?
Blender 5.2 LTS and newer, on Windows, macOS and Linux. No extra Python package is needed.
Where is the panel?
In the 3D Viewport, press N to open the sidebar and click the PLAGALYS tab.
I pressed Animate but no key moves.
Check, in this order:
- The message at the bottom of Blender after Animate — it tells you how many notes were placed.
- The Track menu: after loading a new MIDI file, choose All tracks again.
- Your timeline range: the animation may start later than you think. With Start at first note on, the first note lands on your start frame.
- Playback: on heavy scenes the viewport can skip frames. Scrub frame by frame, or use View › Viewport Render Animation to preview in real time.
The keys are out of sync with my audio.
Make sure your scene frame rate matches the one you plan to render, before pressing Regenerate. If your audio bounce starts at bar 1 of your song while the MIDI region starts later, keep Start at first note on and set the audio file in the panel: it is shifted by the same amount. If your bounce starts exactly with the region, turn the option off.
My DAW exported the MIDI file with a long silence at the start.
That is normal: most DAWs export a region at its position in the song. Start at first note (on by default) skips that silence.
Can I use my own piano model?
Yes. Give each key object a custom property
midi_note (e.g. 60 for middle C), parent the keys to one object, and select that object as the keyboard. Keys rotate around their own origin, so place each origin at the key's hinge.Some notes are outside my keyboard's range.
With Fold out-of-range notes on, they are moved to the nearest octave that exists on your keyboard. Turn it off to ignore them.
The glow does not show.
Tick Glow on press, then press Regenerate. The glow is an emission added to the key materials; in EEVEE and Cycles it needs a little light-to-dark contrast to read well. Raise Glow strength if needed.
Is the sustain pedal supported?
Not yet. It is on our list.
How do I remove the animation?
Press Clear in the panel: every key goes back up and the add-on's keyframes are removed. Nothing else in your scene is touched.
Can I use it in commercial work?
Yes. The add-on is free software (GNU GPL v3 or later), and the keyboards are Creative Commons Attribution 4.0: free for personal and commercial work, please credit PLAGALYS.