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 文件变成互动钢琴课:虚拟键盘上方是下落的音符,还能识别和弦,并提供慢放、循环和移调任意段落的工具。
这是像节奏游戏那样的游戏,还是更偏向学习工具?它是学习和可视化工具,不是游戏:没有计分、没有连击,也没有订阅,只有钢琴卷帘和键盘辅助功能,用来练习真实的歌曲。
我该怎么让它运行起来?从 Releases 页面下载标准的 Windows 安装程序或便携版 .exe,也可以从 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 和卡拉 OK 用的 .kar 文件转换为 MIDI。
我可以编辑或修复混乱的 MIDI 文件吗?可以。内置的音符编辑器和播放编辑器允许你移动、调整长度、重命名、重新分配音轨,以及合并或拆分音轨中的音符;修改会保存为新文件,原文件不会被改动。另外,“点击设定速度”(Tap Tempo)功能还能修正错位的速度图。
作者为什么要开发 Orfeo,而不用 Synthesia?Orfeo 是已停止开发、仅限 Mac 的应用 Rondo 的精神续作。Synthesia 价格变得昂贵,并且加入了游戏化元素却没有同步现代化,于是作者开发了 Orfeo,作为一个持续维护、开源、非游戏化的替代品。
它提供哪些声音引擎?提供三种引擎:GM(即时可用,无需下载)、Studio(基于 SpessaSynth,可下载 SF2/SF3 音色库以获得更丰富的音色),以及测试版的 Native 引擎。Native 引擎直接将音色库输出到声卡,配合真正的 MIDI 键盘时延迟可低于 10 毫秒。
作者
Squarebow
大小
37.2 MB
星标
743
时长
5个月
提交 · 90 天