Free, open-source piano learning software — no account, no subscription, entirely offline.
Practice any piece from a MusicXML file on a MIDI keyboard. Built in Python on pygame as part of the FSFE Youth Hacking for Freedom 2026 competition.
| Project | Type | Description |
|---|---|---|
| Pianove | Application | The app itself — MIDI input, lesson system, score viewer, built-in synthesiser |
| PyLute | Library (PyLute/) |
Music notation renderer built on pygame + Bravura SMuFL font |
| PyLay | Library (PyLay/) |
iOS-inspired pygame UI framework — 29 widgets, spring animations, theming |
PyLute and PyLay are fully independent libraries. Pianove is the application that uses both.
git clone https://github.com/MariusAngermann08/Pianove.git
cd Pianove
pip install pygame
python main.pyA MIDI keyboard is detected automatically if connected. Without one you can still explore lessons in test mode.
| Home | Lesson | Score |
|---|---|---|
![]() |
![]() |
![]() |
- 16 built-in progressive lessons
- Import any MusicXML file (
.xml,.musicxml,.mxl) and practice it immediately - Real-time note detection from any MIDI keyboard
- No MIDI? The piano sound detection engine hears the keys you play on any piano through the microphone (beta)
- Built-in software synthesiser — no external audio setup required
- Full sheet music rendering via PyLute (clefs, key signatures, beams, ties, dynamics, articulations)
- Onboarding wizard with language selection and MIDI device configuration
- Progress tracking and statistics
- Dark and light mode
- Python 3.10 or later
pygame(pip install pygame)- MIDI keyboard (optional)
sounddevicefor playing an acoustic piano through the microphone (optional)
Pianove/
├── main.py # entry point
├── pianove/ # application code
├── PyLute/ # music notation renderer library
│ ├── pylute/ # package source
│ └── pyproject.toml
├── PyLay/ # pygame UI framework library
│ ├── pylay/ # package source
│ └── pyproject.toml
└── docs/ # documentation website (static HTML)
The full documentation site is hosted at mariusangermann08.github.io/Pianove:
- Pianove docs — quick start, MIDI setup, lessons, MusicXML import
- PyLute API reference — notation renderer API
- PyLay API reference — UI framework API
Renders sheet music from MusicXML files or programmatic note input onto any pygame surface. Uses the Bravura SMuFL font, bundled inside the package.
import pylute
score = pylute.load_musicxml("piece.xml", surface=screen)
score.draw()See PyLute/README.md for the full API.
An iOS-inspired UI framework for pygame — widget tree, spring-physics animations, reactive state, dark/light theming.
from pylay import App, VStack, Button, Label
class MyApp(App):
def build(self):
return VStack([
Label("Hello from PyLay"),
Button("Click me", on_tap=lambda: print("tapped")),
])
MyApp().run()See PyLay/README.md for the full API.
- Publish PyLute and PyLay to PyPI so they can be installed with
pip install - Multiple voices on a single staff in PyLute
- Slur arcs and repeat barlines in PyLute
- Test suite (pytest) for both libraries
GNU General Public License v3.0 — see LICENSE.


