# PianoFall

> Free online piano visualizer and MIDI player. Watch notes fall Synthesia-style and learn to play piano directly in your browser — no download, no signup, no cost.

## What is PianoFall?

PianoFall is a web-based piano learning tool at https://pianofall.app. It lets users drop any MIDI file and see the notes fall toward a piano keyboard in the style of Synthesia. Users can plug in a MIDI keyboard and play along, track their accuracy, and practice at reduced speed.

## Core features

- **MIDI visualizer**: Drop any .mid or .midi file to visualize it instantly as falling notes
- **Play-along modes**: Watch (auto-play), Wait (pauses until you press the right note), Free (no restrictions)
- **MIDI keyboard support**: Connect a USB MIDI keyboard via Web MIDI API; notes are detected and scored in real time
- **Microphone pitch detection**: Play along using a real instrument — the browser listens and scores your performance
- **Scoring system**: Tracks hits, misses, accuracy %, combo streaks, and timing quality (Perfect / Great / Good)
- **Speed control**: Slow down playback from 0.5× to 1.5× for difficult passages
- **Loop practice**: Set A/B markers to repeat a section until mastered
- **Sheet music**: Renders a live grand staff (treble + bass clef) synchronized with playback
- **Metronome**: BPM-synced click synchronized to the song's actual beat
- **Multi-track support**: Color-coded tracks; choose which track to play and which play automatically as accompaniment
- **Local library**: Browse a folder of MIDI files from your computer (Chrome/Edge File System Access API)
- **Built-in classical songs**: 8 public-domain pieces ready to play without any upload

## Built-in songs

| Song | Composer | Difficulty |
|------|----------|------------|
| Für Elise | Beethoven | Easy |
| Ode to Joy | Beethoven | Easy |
| Minuet in G | Bach | Easy |
| Shallow | Lady Gaga & Bradley Cooper | Medium |
| Moonlight Sonata | Beethoven | Medium |
| Gymnopédie No.1 | Erik Satie | Medium |
| Clair de Lune | Debussy | Hard |
| Toccata & Fugue in D minor | Bach | Hard |

## Who is it for?

- Beginners learning their first piano pieces
- Intermediate players who want to sight-read or learn songs by ear
- Anyone who wants a free Synthesia alternative in the browser
- Piano teachers looking for a free visualization tool
- Musicians who want to visualize MIDI compositions

## Technical details

- Runs entirely in the browser (no server-side processing)
- Built with vanilla JavaScript, Canvas 2D API, Web Audio API, Web MIDI API
- No account required, no data uploaded — MIDI files stay on the user's device
- Works on Chrome, Edge, Firefox, Safari (MIDI keyboard requires Chrome/Edge)

## Contact

Feedback and questions: info@pianofall.app
Website: https://pianofall.app