- Автор
- dsmurrell
- Размер
- 7.8 MB
- Звёзды
- 428
- Обновлён
- КоммитNov 13Релизv0.3.1Nov 11
- Возраст
- 1 мес
- Коммиты · 90 дней
README проекта с github.com/dsmurrell/onkey. Одним файлом markdown: README.md.
Learn to sing the songs you love. · singonkey.app
Saving shower singers from themselves since 2026.
Me singing along to a song OnKey learned from one play. The full demo, with sound.
OnKey is a free, open-source singing trainer for the Mac. Play a song in Spotify, Apple Music, or YouTube in a browser, and sing along. The first time, you get the lyrics, and OnKey learns the singer's melody when the song ends. After that, the notes scroll towards you, your pitch is drawn over them, and you get a score with a report on every line.
OnKey doesn't provide, stream or download music. Your own music app plays it.
You need a Mac with Apple Silicon (M1 or later) and macOS 14.2 or later.
Download OnKey.dmg (from the latest release), open it and drag OnKey to Applications.
Setup asks for the microphone, to hear you, and for system audio recording, to hear the music app. It also asks whether OnKey may follow Spotify and Apple Music: choose Listen only and it follows songs by their sound alone. Getting started walks through it, and the FAQ answers the usual questions.
When a song ends, OnKey learns it on your Mac: a model separates the lead vocal from the music, CREPE tracks the singer's pitch, and the GAME note model turns it into one bar per syllable. On later plays it finds its place from the music itself and tracks your voice live. Singing an octave down counts, and being a touch late isn't punished. How it works and Scoring have the details.
OnKey never saves the music it listens to. It analyses the sound in memory as it plays. Your recordings and the songs it learns stay on your Mac (a take sung over speakers can contain some of the music). There's no account, no analytics and no crash reporting.
These requests do go out:
Settings has a switch for Shazam, for lyrics and for the update check. Privacy lists everything OnKey keeps and sends, and scripts/release-hosts.txt lists every web address in a release.
OnKey is for practising at home, with music you're entitled to play. Please:
Rights holders can reach me at [email protected] (LEGAL.md).
Use Report a problem in the app (Settings, the Help menu, or a take's page). It saves a zip of numbers and logs on your Mac, with no audio and no recordings of you, for you to attach to an issue if you want to. Troubleshooting covers the common problems. Questions, or a song that's out of step? Ask in OnKey's Discord, or email [email protected].
If you'd rather not trust my build, you can build your own. You need an Apple Silicon Mac with the Xcode command line tools, Rust, Node, and Python 3:
git clone https://github.com/dsmurrell/onkey && cd onkey
npm install && npm --prefix ui install
python3 -m venv .venv && .venv/bin/pip install -r scripts/requirements-models.txt
PYTHON=.venv/bin/python scripts/fetch-models.sh # downloads the models and checks them by SHA-256
npx tauri build
Your build runs on your own Mac. The one thing it can't do is ask Shazam to name a new song, which needs my Apple
signature. Spotify and Apple Music say what's playing themselves, so that only affects YouTube and Listen only. CONTRIBUTING.md has the details, the tests, and how to check a release's checksums. My
releases are signed with my Apple Developer ID and notarised by Apple (spctl -a -vv /Applications/OnKey.app
shows who signed it).
MIT. See LICENSE. Modified versions can't be called OnKey or use its icon. If you build on OnKey's code, a credit linking back here is appreciated.
OnKey learns songs with CREPE, GAME, wav2vec 2.0 and UVR's MDX-Net Karaoke 2. The credits list each one, and THIRD_PARTY_NOTICES.md has the full notices and licence texts.
OnKey is made by Daniel Murrell.