Skip to content
SquarebowPublic

About

A modern piano-learning and MIDI visualization cross-platform app — falling notes, interactive chord & scale explorers, real-time chord detection. From MIDI to mastery.

Topics

Resources

Contributing

Stars

770 stars

Watchers

4 watching

Forks

Repository files navigation

Orfeo

From MIDI to mastery. Turn any MIDI file into an interactive piano-learning experience.

Version License Platform

📖 User manual: orfeo.cc/docs

Orfeo is free. If it helps your playing, you can support it on Ko-fi or GitHub Sponsors.

Orfeo mid-playback: falling notes on the keyboard, keys lit in track colours, the live chord name above


Orfeo is a free, open-source, cross-platform desktop app that turns MIDI files into an interactive piano lesson: notes fall onto a virtual keyboard in real time, keys light up as they play, and you can slow down, loop, transpose, and explore any passage at your own pace. Real-time chord detection, hand-coloured keys, interactive chord and scale explorers, a full mixer, and per-note editing — with a piano roll that looks like it was built this decade.

It's not a game — no scoring, no streaks, no subscription. No account, no telemetry; MIDI files are processed entirely on your device.

Contents


Features

Piano Roll & Playback

  • Import .mid / .midi, plus MusicXML, Guitar Pro, Capella, and karaoke .kar (converted automatically)
  • Falling-note piano roll onto a 61 / 73 / 88-key keyboard, colour-coded per track, pixel-aligned to each key. Small studio keyboards get their own 25 / 37 / 49-key sizes with octave buttons (Portable keyboards), and every size change glides smoothly
  • Tempo control — slow down or speed up without changing pitch; long-press the BPM arrows to glide to a target, or double-click the BPM to type one
  • Change key — transpose the whole piece by semitones
  • Loop region — draw a loop directly on the waterfall and drill any section
  • Metronome — follows the file's embedded tempo map through mid-song changes; right-click for volume and count-in
  • Count-in — 1–4 bars of clicks before the music starts, at the song's real tempo, leading straight into the first note
  • Skip empty bars — songs open where the music starts, with silent lead-in bars left out (a drum count-in can stay); the file itself is never changed
  • Tap Tempo — fix songs whose bar lines and metronome don't match the music: tap along on Space or a MIDI key, and Orfeo lines your beat up with the song's own drums and bass, remembers it for that song, and never touches the file
  • Rebuild tempo — for a song that's wrong from the start, tap it again from the beginning in File Info, or copy the bars and tempo from a better version of the song in your Library
  • Bars of any length — type the beats in a bar or a repeating pattern like 3 3 3 4, change the bars from any point in a song, and get a hint when the music repeats over a length your bars can't fit
  • Tempo warnings — optional marks in the Library and the top bar for songs whose bar lines and metronome don't match the music's beat
  • Tracks panel & Console Mixer — mute, solo, recolour, show/hide tracks (hide a part to hear it as accompaniment without seeing it on the roll or keys); per-channel volume, pan, chorus, reverb with live VU meters; master Tone and Compressor
  • Edits badge — counts your unsaved changes next to the song length; hover for the list, click to save them all at once. Tracks panel changes (mute, show and hide, keyboard lights) are for the session, or saved with the song when you turn on Save track changes
  • Focus Mode — one click to hear keys, bass and drums but see only the keys; click again and every track comes back as it was
  • Export to audio — save any song as MP3 (320 kbps) or WAV (CD quality): as written, keys + bass + drums only, or exactly as you hear it (tempo, key, muted parts, Mixer, loop), with the Studio or Native sound
  • Presentation Mode (F11) — distraction-free view of just the roll and keyboard

Interactive Keyboard

  • Click or drag to play; drag across keys for glissando
  • Docked or floating — a draggable, resizable panel for multi-window setups
  • Key highlighting in track colour, with the chord name shown live above
  • Automated hand assignment — notes colour-code by which hand plays them, in Practice (moving split line) or Performance (per-note tags) mode, with optional colourblind-friendly L/R badges, and hand colours of your choice (ready-made pairs, colour-blind friendly ones included, or your own). A piano on two staves takes its hands from the staves; otherwise Orfeo works them out and says how sure it is ("about 95% likely right"), then loops the passages it's least sure of so you can keep them or fix them
  • Hardware MIDI input — play along on a real keyboard with true sustain and multi-device support. A dedicated MIDI Keyboard page in Settings lists every keyboard by name and sets touch response, pedals and controls, and a double-note filter, with a Delay check that shows where every millisecond between key and speaker goes. Orfeo learns each keyboard's number of keys once (press the lowest and highest key), and a keyboard with lighted keys can show the song's notes
  • Step Through — walk through a song one note or chord at a time with → and ←, at your own pace

Chord & Scale Explorers

  • Chord Explorer — browse and audition any chord in any key; filter by hand span or note count; cycle inversions; play progressions in nine chord styles
  • Scale Explorer — interactive Circle of Fifths; ten scale types, each with its diatonic chords and Roman numerals
  • Real-time chord detection with three tracking modes (Auto, Harmony, Follow Instrument)
  • Chord Prompter — a lead-sheet-style past / current / next readout synced to playback
  • Chord Transcription (beta) — generate a printable chord chart PDF for any file
  • Lock-a-Chord — Shift+click any 3+ keys to build and lock a chord, then cycle inversions

MIDI Editing

  • MIDI Playback Editor — exclude, rename, recolour, reassign instrument, merge, and split-hands tracks; saves as a new _ORFEO_vN.mid without touching the original
  • Note Editor — move, resize, add, delete, and re-velocity individual notes on the roll, with marquee / lasso / pen tools and full undo/redo
  • MIDI library — browse a folder, star favourites, fuzzy-search, auto-refresh, and show Artist - Song files song first with one click. Tag songs your way, see which have lyrics, plan a session with the practice queue, and widen the Library by dragging its edge
  • Open with Orfeo — double-click a .mid, .midi or .kar file to open it
  • Edit history embedded in the file — travels with the .mid anywhere, survives reinstalls

Visual Flourishes

  • Hit effects — seven optional particle animations where notes strike the keyboard (glow bloom, ripple ring, particle burst, smoke plume, colour aura, starburst nova, comet trail), with custom colour and a real bloom filter

Audio

  • Master volume — a physical-feeling toolbar knob, persists across sessions
  • Three sound engines — GM (General MIDI: instant, no download), Studio (SpessaSynth + downloadable SF2/SF3 soundfonts, GeneralUser GS by default) for far richer sound, and Native (beta, Windows only for now), which plays the same soundfonts straight to your sound card so a MIDI keyboard is heard in under 10 ms. Native mixes songs like Studio and has two modes: Shared (other apps keep playing) and Exclusive (the shortest latency from keyboard to speaker, 3-10 ms in average, depending on your sound card). A connected keyboard switches it to Exclusive by itself
  • Your own mix, played as written — both engines follow a song's own volume swells and fades, tracks sharing a MIDI channel share its mix, and parts that change instrument mid-song switch at the right moment

Settings

  • Setup — the everyday switches (sound engine, Focus mode, Tap Tempo, note names, key range, zoom…) in the left panel, each with a one-line explanation
  • Settings window (Ctrl ,) — every setting in eleven groups with full descriptions, a search box, and a link to the matching page of the online manual. Hints can be switched off with the Tooltips switch under Appearance
  • Note names your way — English, German, Solfège or Sargam (in Latin letters or Devanagari), with chord names kept Western
  • Your language — a language switcher with the community translations (see Translations)
  • Two short tours on a first start show where everything is

Full walkthrough of every feature: orfeo.cc/docs.


Download

Grab the latest build from the Releases page:

SystemFileUse
WindowsOrfeo-Setup-<version>.exeInstaller — Start Menu shortcut, automatic updates
WindowsOrfeo-<version>-portable.exePortable — no installation, runs from anywhere, manual updates
macOSOrfeo-<version>-mac-arm64.dmgApple Silicon (M1 and newer)
macOSOrfeo-<version>-mac-x64.dmgIntel Macs
Linux (experimental)Orfeo-<version>-linux-amd64.debUbuntu, Debian, Mint, Pop!_OS…
Linux (experimental)Orfeo-<version>-linux-x86_64.rpmFedora, openSUSE…
Linux (experimental)Orfeo-<version>-linux-x86_64.AppImageAny other distribution, no installation

On Windows, Orfeo is also in the Microsoft Store, which keeps it up to date for you.

Not sure which, or want to know how they differ (auto-updates, where settings live)? See docs/INSTALLATION.md.


Documentation

DocumentWhat's in it
User manualThe complete guide — Play, Edit, Practice, Manage files, Extras (online at orfeo.cc)
RoadmapWhat is being built next
ShortcutsEvery keyboard and mouse gesture
InstallationDownloads for each system, updates, where data lives
ArchitectureHow Orfeo is built and why
ChangelogTechnical release history
ContributingBuild from source, cut a release

Building from source

git clone https://github.com/Squarebow/Orfeo.git
cd Orfeo
npm install
npm run dev

Requires Node.js 20 LTS or newer. Full build and release instructions, including macOS/Linux, are in docs/CONTRIBUTING.md.


Translations

Orfeo's community translations are hosted on Weblate. Turn on Show language switcher in Settings › Language; a language can be chosen there once 80% of it is translated.

Deutsch Français Español Português Polski Русский Slovenščina 简体中文
Translation status Translation status Translation status Translation status Translation status Translation status Translation status Translation status

FAQ

Is Orfeo free?

Yes — completely free and open source. No subscription, no paywalled features, no account.

Does it need an account or an internet connection?

No account, no login, no telemetry — and no internet connection is needed to play, practise or edit. MIDI files are processed entirely on your device, and every sound engine works offline: the default sound set (GeneralUser GS) ships inside the installer.

Orfeo only goes online when you ask it to, or to check for updates:

  • Extra sound sets (FluidR3 GM ~142 MB, MuseScore General ~38 MB) are not in the installer; each is downloaded once, only when you press its download button in Settings → Audio, and kept in %APPDATA%\Orfeo\soundfonts\ (your own imported .sf2 / .sf3 files go there too).
  • Updates: the Windows installer, portable, Mac and Linux versions check GitHub for a new release when they start. The installer version then updates itself; the others show a dot on the update button that opens the download page. Check for updates in the Microsoft Store version opens Orfeo's Store page. Offline, this simply doesn't happen.
  • Links (user manual, GitHub) open in your web browser.
What platforms does Orfeo run on?

Windows 10/11, with an installer and a portable build; macOS on Apple Silicon and Intel Macs (INSTALLATION.md → macOS); and Linux on x64 as AppImage, .deb and .rpm (INSTALLATION.md → Linux). The Linux builds are experimental for now: they're built and start-checked automatically with every release, but still waiting for testing on real Linux machines with a MIDI keyboard.

Does Orfeo support Finale, Sibelius, or MuseScore files?

Not their native formats directly — but all three export MusicXML, which Orfeo imports and converts to MIDI automatically. Guitar Pro, Capella, and karaoke .kar files are supported natively too.

What MIDI files work best?

Real, human-performed files with natural rubato and mid-song tempo changes — Orfeo tracks the tempo map properly instead of assuming a flat click. Cleanly quantized files work great too. Messy downloads can be cleaned up with the Playback and Note editors without touching the original.


Why Orfeo

Before Synthesia there was Rondo — a lovely, Mac-only MIDI learning app with a scrolling piano roll, tempo slowdown, and track filtering. Development stopped and it no longer runs on modern macOS. The alternative that filled the gap became expensive and gamified, and hasn't meaningfully modernized in years.

Orfeo picks up Rondo's idea, rebuilt from scratch as an actively maintained, cross-platform app with one goal: make the music itself — not the app around it — the focus. Free forever, no gamification, real rubato support, open source, and a modern interface.

Inspired by Rondo (RIP).


License

GPL-3.0-or-later © SquareBow — see LICENSE.md. Bundles GSAP under a separate additional-permission grant; see the top of THIRD_PARTY_LICENSES.md.

About

A modern piano-learning and MIDI visualization cross-platform app — falling notes, interactive chord & scale explorers, real-time chord detection. From MIDI to mastery.

Topics

Resources

Contributing

Stars

770 stars

Watchers

4 watching

Forks

Releases

Sponsor this project

Packages

Used by

Contributors

Languages