Pianola

🎹 Smoothest piano roll visualizer 🎹


Links • GitHub • Documentation • License • Support
_{⭐️ Consider starring the project to help it grow! ⭐️}

^{⚖️ The Entertainer by Scott Joplin (Public Domain), GeneralUser GS SoundFont}

🔥 Description

Pianola is an elegant and dynamic piano roll visualizer written in Python and GLSL Shaders, with a focus on quality, performance and visuals - powered by the shaderflow engine.

• Spring physics model governing many animations, providing a realistic and organic feel to the visuals.
• Unlimited rendering with any framerate, resolution, or supersampling you want
• Commercial use allowed and encouraged, simply pick a sponsorship tier!

📦 Getting Started

🚧 Under maintenance (reworking website) • For now, either: 👷

Command line

Run with uvx pianola main

• Export videos with pianola config --midi file.mid main --ssaa 2 --output output.mp4
• Add your own audio pianola config --audio file.flac (...)
• See options pianola main --help, pianola config --help

Dependency

Add into your pyproject.toml:

[project]
dependencies = ["pianola"]

Check usage in the Examples directory!