Skip to content
Suma-UddPublic

About

Turn a MIDI file or a piano recording into a Synthesia style falling notes video.

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

25 Commits

Folders and files

Repository files navigation

NoteFall: piano music in, falling notes out

Turn piano music into a falling notes video.
Give it a MIDI file or just a recording of someone playing. Get a video back, ready to post.

Latest version Downloads Windows, Mac and Linux Tests MIT license

Download for Windows Download for Mac Download for Linux

Free, no account, no watermark. Everything runs on your own computer.


See it

Bach's Prelude in C as glowing falling notes
Midnight look. Watch with sound: YouTube shape · phone shape
The Paper look: hand drawn notes, labelled keys, chord names and animated hands
Paper look. With sound

Bach's Prelude in C, straight out of NoteFall. Nothing edited by hand.

What it does

🎹 MIDI in, video out

Every note lands on the exact key, left hand in one colour, right hand in another.

🎧 No MIDI? Use a recording

An mp3, a phone recording or a video of someone playing. NoteFall listens with a piano only model, writes down the notes and the pedal, and keeps the real sound.

📱 Ready to post

Phone (TikTok, Reels, Shorts), YouTube or square, in smooth 60 fps.

✋ Hands that play

Two animated hands glide over the keys and press each note on the beat. Every look has them.

🎨 Six looks

Glowing notes on a dark stage in five colour sets, or Paper: a sketchbook page with every key and note named and the chord on screen. No sheet music needed.

🔄 Updates itself

Click Check for updates in the app. On Windows it downloads, installs and reopens in one go.

The app

The NoteFall app

Light and dark mode. It follows your computer, and the button in the corner switches it.

Get it

  1. Open the download page and scroll to Assets. Grab the file for your computer:

    your computer the file to download
    🪟 Windows NoteFall-…-windows-x64-Setup.exe
    🍎 Mac with an Apple chip (M1 and newer) NoteFall-…-mac-arm64.dmg
    🍎 Older Intel Mac NoteFall-…-mac-x64.dmg
    🐧 Linux NoteFall-…-linux-x64.tar.gz

    Not sure which Mac you have? Click the Apple menu, then About This Mac. If it says Chip: Apple M… take arm64, if it says Processor: Intel take x64.

  2. Windows: open the Setup file and click Install. No admin password needed, and NoteFall shows up in the Start menu.
    Mac: open the .dmg and drag NoteFall onto Applications.

My computer says the app might be unsafe

That's because the app isn't signed by a big company (signing costs money every year). It's the same app, built in the open right here by GitHub.

  • Windows: click More info, then Run anyway.
  • Mac: open NoteFall once, then go to System Settings → Privacy & Security and click Open Anyway.

You only do this once.

How do updates work?

NoteFall checks for a new version when it opens, and you can check any time with the Check for updates button under Create Video. On Windows one click downloads the new version, installs it and reopens the app. On a Mac it opens the download page so you can grab the new .dmg.

If you're on 0.3.0 or older, download the new version by hand once. After that it's automatic.

Prefer a one line installer?

It installs NoteFall with a shortcut, needs no admin password, and you can run it again any time to update.

Windows: open PowerShell, paste this and press Enter:

powershell -ExecutionPolicy ByPass -c "irm https://raw.githubusercontent.com/Suma-Udd/notefall/main/scripts/install.ps1 | iex"

Mac or Linux: open Terminal, paste this and press Enter:

curl -LsSf https://raw.githubusercontent.com/Suma-Udd/notefall/main/scripts/install.sh | sh

Make a video

  1. Open NoteFall and click Choose…. To try it right away, use examples/prelude_in_c.mid.
  2. Pick a format and a look. The preview moves as you change things.
  3. Click Create Video and pick where to save it.
  4. When it's done, click Play. That's it.

Tip

A MIDI file is exact, a recording is a very good guess. For the cleanest result from a recording, use one with just the piano in a quiet room. The guide has more tips.

Learn more

📖 Guide where to find MIDI files, using recordings, the sustain pedal, common questions
⌨️ Command line every option, and using NoteFall from Python
⚙️ How it works how the video gets drawn, and why it's fast
🛠️ Contributing run it from source, tests, building the apps
🗒️ Changelog what changed in each version

Found a bug or have an idea? Open an issue, there's a short form for each.

Credits

Recording to notes uses ByteDance's piano transcription model (Kong et al., code MIT, see docs/licenses/piano-transcription.md), with Basic Pitch by Spotify (Apache 2.0) as the fallback. Text is set in Inter and the Paper look in Kalam (both OFL). MIDI reading by pretty_midi, video by FFmpeg. The Basic Pitch and font licenses live in notefall/assets.

NoteFall itself is MIT licensed, see LICENSE.

About

Turn a MIDI file or a piano recording into a Synthesia style falling notes video.

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages