Orfeo README

README проекта с github.com/Squarebow/Orfeo. Одним файлом markdown: README.md.

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

Interactive Keyboard

Chord & Scale Explorers

MIDI Editing

Visual Flourishes

Audio

Settings

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 (the language switcher is coming in Orfeo 1.8).

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.

Orfeo (Squarebow/Orfeo)

Ищем в базе…

743 ·GitHub
Что это такое?Orfeo — это бесплатное приложение с открытым исходным кодом для Windows, которое превращает MIDI-файлы в интерактивный урок игры на фортепиано: падающие ноты на виртуальной клавиатуре, распознавание аккордов и инструменты, чтобы замедлять, зацикливать и транспонировать любой фрагмент.
Это игра вроде ритм-игры или скорее инструмент для обучения?Это инструмент для обучения и визуализации, а не игра: никаких очков, серий и подписки — только пианоролл и подсказки на клавиатуре для разбора реальных песен.
Как его запустить?Скачайте стандартный установщик для Windows или portable .exe на странице Releases либо получите приложение в Microsoft Store, а затем просто откройте MIDI-файл (или MusicXML/Guitar Pro/Capella/.kar), чтобы начать.
Нужна ли MIDI-клавиатура или аккаунт, чтобы пользоваться программой?Аккаунт и подключение к интернету не требуются, а аппаратная MIDI-клавиатура необязательна — можно нажимать или перетаскивать ноты на экранной клавиатуре, хотя подключение настоящей клавиатуры добавляет режим игры вместе с треком с низкой задержкой.
Работает ли она и на Mac, и на Linux?Официально пока нет — Orfeo сейчас выпускается только для Windows 10/11; так как приложение построено на Electron, сборки для macOS и Linux технически возможны и их может собрать сообщество, но официальных сборок для этих платформ нет.
Покидают ли мои данные или файлы устройство?Нет, MIDI-файлы обрабатываются полностью на вашем устройстве, телеметрии нет; в интернет приложение выходит только для загрузки необязательных дополнительных саундфонтов или проверки обновлений.
Какие форматы файлов, кроме .mid, можно импортировать?Orfeo напрямую открывает .mid/.midi и также автоматически конвертирует файлы MusicXML, Guitar Pro, Capella и караоке-файлы .kar в MIDI.
Можно ли редактировать или исправить неаккуратный MIDI-файл?Да: встроенные редакторы Note Editor и Playback Editor позволяют перемещать, изменять длину, переименовывать, переназначать, объединять и разделять ноты дорожек; изменения сохраняются в новый файл, оригинал не трогается. Функция Tap Tempo также исправляет неверные карты темпа.
Почему автор создал Orfeo вместо того, чтобы использовать Synthesia?Orfeo — духовный преемник прекращённого приложения Rondo, которое работало только на Mac; его сделали активно поддерживаемой альтернативой с открытым исходным кодом и без геймификации, потому что Synthesia подорожала, стала геймифицированной и при этом не обновлялась.
Какие звуковые движки здесь есть?Три движка: GM (мгновенный, без загрузки), Studio (SpessaSynth с загружаемыми саундфонтами SF2/SF3 для более богатого звучания) и бета-движок Native, который воспроизводит саундфонты напрямую на звуковую карту с задержкой меньше 10 мс при подключённой настоящей MIDI-клавиатуре.
Какие есть похожие проекты?baiagent-director, stemkit, nota, flyingmouse-format, TreeMap-Disk-Visualizer, Meltype, SCM, Zettlr
Автор
Squarebow
Размер
37.2 MB
Звёзды
743
Возраст
5 мес
Коммиты · 90 дней