Skip to content

ekkx/notefall

Repository files navigation

notefall

A browser-based piano visualizer. Notes fall onto an 88-key keyboard while a MIDI plays — and you can play live, record, edit the MIDI right on the canvas, animate the look along the timeline, and export it all to video.

Your MIDI, recordings, and projects never leave your device. No accounts, no content uploads — everything is processed entirely client-side. (Anonymous, opt-out usage stats only.)

notefall in action

▶ Try it live — notefall.app

Features

  • Falling notes — a MIDI plays back through a sampled concert grand while its notes fall onto a 3D 88-key keyboard, with glow, particles, and bloom.
  • Play live — touch, mouse, PC keyboard, or a hardware MIDI keyboard via the Web MIDI API. Sustain pedal supported.
  • Record — capture a live performance (optional 4-beat metronome count-in) and load it straight back as an editable song.
  • Edit on the canvas — move, resize, split, delete, draw, and marquee-select notes directly on the visualizer. Full undo/redo.
  • Timeline pins — drop settings keyframes along the timeline and the scene morphs between them (camera, colors, opacity, bloom, background, …).
  • Export — offline render to WAV (audio), silent MP4 (video), or a full A/V MP4, with resolution / fps / quality options and live progress + ETA.
  • File-based projects — save/load .nfz project files to your own filesystem (no cloud, no IndexedDB-only fragility), with recent-files support.

Tech stack

  • Vite + React 18 + TypeScript
  • @react-three/fiber + drei + postprocessing (Bloom) for the 3D scene
  • smplr for the sampled grand piano, tone for AudioContext lifecycle
  • @tonejs/midi for MIDI parse/serialize
  • react-aria-components + Tailwind for the UI, zustand for state
  • mp4-muxer + WebCodecs for offline MP4 export

License

PolyForm Shield 1.0.0 — source-available. Permits any use except offering a competing product or service.

About

Piano visualizer with falling notes, live play, MIDI editing, and video export. No install, no signup, works in your browser.

Topics

Resources

License

Stars

Watchers

Forks

Contributors

Languages