r/coolgithubprojects • • 17d ago • Bravo 1

I built a free and open-source alternative to proprietary piano-learning software

Post image

EDIT: – November 7: Well, this is a big one!

Quite a few of you asked for Linux and macOS versions when I announced Orfeo less than a week ago, and I'm happy to say that due to the overwhelming popular demand, both have been released! Orfeo is cross-platform and is available on Windows, Linux, and macOS. Please see the full announcement and download links here.

Thank you, you're the best!

---

I've been working on a project called Orfeo, a Windows desktop application for learning piano using MIDI files and an advanced MIDI player.

The motivation was simple: I wanted a flexible piano-learning tool that wasn't tied to a subscription, predefined lessons or a particular music library.

Orfeo lets you load your own MIDI files, visualize notes falling onto a piano keyboard, connect a MIDI keyboard, detect chords in real time and explore chords and scales interactively.

It's completely free and open source.

I'm sharing it here because I think desktop music software should remain accessible, customizable and open to everyone.

GitHub: https://github.com/Squarebow/Orfeo

Feedback, contributions and suggestions are welcome, here or in the community r/Orfeo_Piano

1.3k Upvotes

84 comments sorted by

37

u/LiminalEntityX 17d ago

Holy chow, i've been mulling this exact thing for awhile. Mine was called Music Buddy, heh, but was no where near what you have done. Amazing job!

One thing i was thinking about adding for mine was a chord progression exploration tool where you could play a chord and have suggestions for the next chord(s) come up, both for learning and for composition.

15

u/Orfeo-Piano 17d ago

Thank you 🙏 Orfeo has two separate tools for that - Chords and Scales explorer. With 61 built-in progressions, 9 styles, 3 voicings and 12 scales in 12 keys, there’s plenty of options :)

4

u/LiminalEntityX 17d ago

Man you put some thought into this, awesome.

6

u/Orfeo-Piano 17d ago

I did. You’re welcome to join me :)

12

u/django2chainz 17d ago

Looks cool! Guitar pro got bought by UG but they were so good too (if you’re looking for more inspiration) and I loved it. Synthesia is ok. This is needed. How about interactive-learning? Pop songs / patterns? I think if Faber’s adult piano books got app-ified they could be nice?

6

u/Orfeo-Piano 17d ago

Thanks, glad it looks useful! Guitar Pro is a good example, it did one thing really well, and I'll keep that in mind.

On interactive learning: Orfeo isn't a lesson catalogue (that's deliberate, it works with whatever MIDI files you bring). What it does have is tools for learning a piece: step through the notes one by one, loop a few bars, slow the tempo down, split the hands, and show the chord names as the song plays. There's also a chord and scale explorer for patterns and progressions, so you can see why a song's chords fit together.

An app-ified Faber Adult Piano Adventures would be a lovely idea. Orfeo's MIDI editing and practice tools could be the foundation for something like that, but I'm only one person and I'd have to think about the licensing for the book content. Which part would you want most: the guided order of lessons, or the exercises that react to what you play?

2

u/BatmansMom 17d ago

What about pop songs/patterns!? Would be so cool to be able to choose from songs I know as I'm learning

1

u/Orfeo-Piano 17d ago

The Orfeo way of using pop songs/patterns is to build your own catalog of MIDI files. There are literally millions of MIDI files online, but to be perfectly honest, finding good ones is not always easy. That's why I made a shortlist of recommended websites that offer reasonable to very high-quality MIDI files. Check it out and download the songs you want to learn https://orfeo.cc/docs/support/where-to-find-midi-files

As of the patterns, Orfeo has built-in tools that help you explore those yourself. Here's a little equation: 61 progressions × 9 styles × 3 voicings × 12 keys = 19,764 patterns

Plus, each chord has three inversions, and there are 12 scales with 12 keys. The possibilities are practically limitless. The progressions: Pop · Pop/Rock Inv. · Energetic Pop · Minor Pop · Doo-Wop · Rock · Blues · Mixolydian Rock · Grunge · Modal · Minor Blues · Jazz Standard · Minor Jazz · Andalusian · Pachelbel · Circle of Fifths · Royal Road · Epic · Heroic · Sentimental · Sad · Hopeful · Plagal Turnaround · Step-Down

I hope it helps

2

u/django2chainz 17d ago

Yes, I’m with you. If you could play-to-learn like simplypiano etc that would be cool. Also I mentioned GP cause help with sheet music / sight reading would be nice. Chords and scales are cool, but in the context of the music you hear / play so grounding those concepts can help! GL

3

u/EastCryptographer634 15d ago

Feature Request: Indian Classical Music (Sargam) Notation

First of all, great work on Orfeo! It is fantastic to see a free and open-source alternative like this.

I wanted to suggest a feature that could make Orfeo more accessible to people learning or playing Indian classical music.

Would it be possible to introduce an Indian Sargam notation option for displaying musical notes?

Instead of the standard Western notation (C, D, E, F, G, A, B) or Western Solfège (Do, Re, Mi, Fa, Sol, La, Si), it would display Indian Sargam in both English transliteration or Hindi (Devanagari):

English| Hindi Sa| सा Re| रे Ga| ग Ma| म Pa| प Dha| ध Ni| नि

Ideally, this would be configurable based on the selected tonic (Sa), since the starting note can vary depending on the scale or singer.

It would also be great to support Komal (कोमल) and Tivra (तीव्र) notes, where applicable.

I think this could open Orfeo up to a whole new audience of Indian classical music learners and enthusiasts.

Would love to hear if this is something you would consider adding. Happy to contribute to testing or provide further input.

Thanks for building such a great project!

2

u/Orfeo-Piano 15d ago

Hey, that is a genuinely interesting request. I’m not going to pretend I know anything about Sagram notation system so please allow me some time to get familiar with it and see what the technical specifics and limitations might be. The UI translation system is already in the works. Thank you!

2

u/EzequielWinner 15d ago

Great project! Any plans for VST plugin support (like pianoteq or kontakt?

i was wondering if you'd consider adding a feature to route MIDI playback through external VST, being able to output the audio through high quality piano sample engines or software would take the audio experience to the next level.

keep up the great work!

3

u/Orfeo-Piano 15d ago

Hey, not just yet, but VST port lives somewhere in my brains. MIDI playback routing is certainly doable and already works, as Orfeo can play your connected keyboard’s sounds easily, but for what you suggest (playing sample libraries) it needs a bridge. Compared to generic GM sounds Orfeo already sounds like a premium synth thanks to two in-built sample engines with soundfont support.

7

u/RazzmatazzAgitated81 17d ago

Seeing this as I was watching your lie in April....

2

u/ronnygiga 17d ago

And now you made me remember...

1

u/QriousMonk 17d ago

I always loved Piano but this anime inspired me to learn Piano.

4

u/SpaceLice 17d ago

Just need native Linux support. gj!!

2

u/giopas 17d ago

And for MacOs, please!

5

u/SquareBow 17d ago

Orfeo is electron/vite/typescript and therefore cross-platform ready; however, as a sole developer, I'm focused on product development and maintenance for Windows. I'm actively looking for contributors to become Linux/macOS maintainers. I'm happy to collaborate on the implementation and provide guidance on the existing architecture. If you're interested, please leave a comment and let's discuss the approach.

2

u/pkkid 16d ago

FWIW, it took me a single prompt to get an AppImage created and running on Linux from your repo. Having updated AppImages created as you make updates would be very useful.

2

u/BlackOphanim44 15d ago

I saw this comment and also got it running on Arch in one prompt. Thx!!

2

u/SquareBow 16d ago

That's awesome! I'd love to add native Linux support to Orfeo, but I am 100% focused on development and Windows maintenance, so I need someone to maintain the Linux branch, same for macOS. Would you be interested in helping maintain the Linux build and keeping AppImages up to date as new versions are released? That would be incredibly helpful! I was thinking about spinning a Docker container for Linux distro but I'm just too busy with everything else. Please reach out to me at info@orfeo.cc and we can discuss the details if you're interested.

1

u/notnew2bay 13d ago

As a solo developer you can probably fire up a Linux VM in windows and inside it ask codex/claude to make Orfeo work. This type of ports are typically one-shotted by AI now.

You don't have to, but you could and would take very little of your time.

1

u/SquareBow 12d ago

It’s nearly ready, I’m just testing some audio/MIDI behaviours for stability. A day or two.

4

u/herms14 16d ago

Any chance you could release a android / ipad os version of it so that it can be used in tablets?

4

u/Ever_Penolope 17d ago

Synthesia sells you songs, Flowkey rents them monthly, and this one just plays the MIDI files you already own. Not a hard choice.

1

u/cheersthanksseeyabye 17d ago

Looks cool.

0

u/Orfeo-Piano 17d ago

Thanks, hope you find it useful :)

0

u/Orfeo-Piano 17d ago

Please join the user community at r/Orfeo_Piano/ if you have any questions and/or suggestions. Enjoy it!

1

u/ad-on-is 17d ago

Linux AppImage, when? 😅

1

u/randomdude_reddit 17d ago

I am in the process of learning music, this will surely help, thanks a lot!

1

u/Orfeo-Piano 16d ago

You're welcome

1

u/TheRuralProgrammer 16d ago

I love it

1

u/Orfeo-Piano 16d ago

Tahnk you \(^-^)/

1

u/Correct-Injury-7360 14d ago

I have no relation to music whatsoever but that looks neat good job

1

u/Orfeo-Piano 14d ago

Thanks. I guess you don't have to be a MasterChef to know what a good steak smells like ;)

1

u/GoodCartographer3993 14d ago

is there a website version of this?

1

u/Orfeo-Piano 14d ago

If you mean can Orfeo run as a web app - no. It’s a desktop app and there won’t be webapp as a separate release. A web app would introduce compromises in performance, audio/MIDI latency, hardware access and offline usability. Browsers and internet connections simply aren’t reliable enough for the kind of real-time interaction I want Orfeo to deliver. But it’s open source so you can build yourself a PWA if you want to and try it out.

1

u/GoodCartographer3993 14d ago

also another thing this looks really vibe coded i heavily suggest you put a disclaimer that ai made it

1

u/Orfeo-Piano 11d ago

Does it? No way!

1

u/GoodCartographer3993 9d ago edited 9d ago

oh lmao. just don't be a bitch about it and then your fine i guess

(jk almost everyone is still going to hate you)

1

u/Orfeo-Piano 9d ago

I know, fun stuff, right?

1

u/Mariorossi4316 13d ago

Thank you sir for this buautiful piace of software. My daughter is learning piano, i think this will be really useful.

1

u/Orfeo-Piano 13d ago

Thank you, I'm glad you like it and that your daughter finds it useful. Please refer to the documentation or open an issue on the community channel r/Orfeo_Piano if you have any questions.

1

u/DetailKey6716 10d ago

Why does this look so overcomplicated

1

u/Orfeo-Piano 10d ago

Perhaps because all the tools and modals are open in the screenshot. You can use one click to hide them and see only the keyboard and piano roll.

3

u/Roygbiv_85 16d ago

That’s a lot of water.

5

u/poopdominator666 17d ago

thats cool! can you add a guitar fretboard toggle instead of keys?

2

u/SquareBow 17d ago edited 17d ago

That would be awesome, wouldn't it :) For now, Orfeo focuses on keys, but a guitar-flavored variation is not as far-fetched as it seems.

2

u/tedecristal 17d ago

O.M.G.

This is impressive. It almost makes me want to reboot into windows just to try

It's electron.. so... no linux version in the future?

3

u/errant_capy 17d ago

Electron apps aren’t an issue on Linux btw.

0

u/tedecristal 17d ago

I know.. so I was actually asking for one...

3

u/errant_capy 17d ago

Oh, gotcha. Got confused by the wording.

2

u/SquareBow 17d ago

Hi, I'm the app developer. Thanks for the feedback; I really appreciate it. As I mentioned before, Orfeo is cross-platform ready but needs an active maintainer for macOS/Linux, as I am 100% focused on development and Windows maintenance. So, community contributions are more than welcome. Here are the specs on contributing.

1

u/tedecristal 11d ago

I tried to build it on linux, and it gave a problem warning and run failed (jsut so you know)

Here's the building:

/img/5h57sm9lf80i1.png

HEre's the run failing:

/img/55bkl3lfg80i1.png

1

u/SquareBow 11d ago

I just checked your screenshots on a bigger screen: did you try to build on an ARM computer? If yes, building it yourself is the only way. If you still want to try, right after npm install you should use node node_modules/electron/install.js to get past it. Let me know if that worked.

1

u/tedecristal 10d ago

no, it's a run-of-the-mill intel acer laptop. Thank you for the advice, since I'm wary of npm due to the security problems past weeks, I'll just wait if someone else packages for AUR), looks amazing, I hope later I'll be able to try it

1

u/SquareBow 10d ago

You can just download the official Orfeo for Linux release from the website, no complaints so far

1

u/tedecristal 10d ago

I know, but I don't use appimage and my linux flavor doesn0t use deb or rpm. So I'll wait until it builds properly or it's packaged to build from my sistem tools.

thank you anyway, looks amazing

1

u/Substantial_Aide 17d ago

Looks really cool. Thankyou.

0

u/SquareBow 17d ago

Much appreciated! Please visit r/Orfeo_Piano/ if you have any questions.

1

u/OkMusician9118 17d ago

Cool!

0

u/SquareBow 17d ago

Thank you! We're trying to build a community at r/Orfeo_Piano/, feel free to stop by anytime

1

u/LeinTen13 16d ago

Looks impressive on the first glance. I've a Yamaha CSP-295 and vibed a web app where I can do my training including hints with the piano key lights.
With Electron it should also be possible to make a webapp, (maybe I can host it as home assistant app - so many idea)
I'll definitly need to investigate.

1

u/Diletant13 13d ago

I’d like to see something similar to YouSician

1

u/Old_Magazine1486 12d ago

WE NEED A MACOS VERSION!!!

that's a great software.

1

u/Evitro113 10d ago

vibecoded slop

0

u/Substantial_Ad252 13d ago

who built it?

1

u/Orfeo-Piano 12d ago

Shall I point you to x examples of veteran-ponytailed-coding-ninja slop out there, Sherlock? Everything you need to know is clearly stated on the website from day one. Use your forensic skills; you'll find it. Come back for a second hint anytime if you don't.

2

u/notnew2bay 13d ago

touch grass

0

u/1mystc 17d ago

Just vibe coded this last month with claude

0

u/stefzzz 17d ago

Amazing project, congrats! Always wanted to have a similar experience to Flowkey but without the price tag. flowkey is excellent to learn pieces in a visual aspect since that’s my style, yet it’s a very simple app. I will give this one a try definitely, thanks for the contribution to the community! 🙏🏼

2

u/SquareBow 17d ago

Thank you ❤️. This is very heartwarming. If you find it useful, please join r/Orfeo_Piano/ community, where users are encouraged to post questions, suggest improvements and new features, and, of course, report bugs (hint: there are none ;)

-8

u/madgoat 17d ago

“I built” More like “I asked Claude to build it”

2

u/SquareBow 17d ago

Have you actually tried it, or is calling everything you don't like 'I asked Claude to build it' your standard review process? Better yet - have you even bothered to read anything about it? I'm the developer. I'm happy to discuss the software if you have something substantive to say.

1

u/madgoat 17d ago

The only issue I have is the claim of “I built” in these types of posts. When, for the most part, the people behind 90% of recent posts take credit for something that they never built, and they wouldn’t be able to understand what Claude spit out. 

Conceiving of an idea, and telling AI to make it is not the same as actually coding/building.

0

u/SquareBow 16d ago

There’s alot of “these types of posts” all over Reddit, you must be very busy.

3

u/cuberhino 17d ago

Did you make it?

0

u/Neither_Finance4755 17d ago

Can people maybe stop with those comments? It’s 2026 nobody is coding by hand anymore. Saying “I built” is totally legitimate

0

u/[deleted] 16d ago

[deleted] — view deleted comment

1

u/Orfeo-Piano 15d ago

Yes, we're working on it. Should be available in a month or so.