dsmurrell/onkey

Learn to sing the songs you love. A free, open-source singing trainer for Mac that listens to the music you play.

OnKey란 무엇인가요?

OnKey는 Mac용 무료 오픈소스 노래 트레이너입니다. 이미 좋아하는 노래를 배울 수 있도록 멜로디를 보여주고 음정에 대한 피드백을 제공합니다. 마치 당신의 목소리를 듣는 노래방 코치와 같습니다.

음악을 제공, 스트리밍 또는 다운로드하지 않습니다. 당신의 음악 앱(Spotify, Apple Music 또는 브라우저의 YouTube)이 노래를 재생합니다. OnKey는 이를 듣고 안내합니다.

경험 과정

첫 번째 재생: 노래가 재생되는 동안 화면에 가사가 표시됩니다. 노래가 끝나면 OnKey는 그 한 번의 재생으로 가수의 멜로디를 학습합니다.
이후 재생: 음표가 레인처럼 당신을 향해 스크롤되고, 그 위에 실시간 음정이 그려지며(음정이 맞으면 녹색), 줄별 보고서와 함께 점수가 표시됩니다.

학습 및 채점 방식

노래가 끝나면 OnKey는 Mac에서 완전히 처리합니다:

모델이 리드 보컬을 음악에서 분리합니다.
피치 트래커(CREPE)가 가수의 멜로디를 추적합니다.
음표 모델(GAME)이 이를 음절당 한 마디로 변환합니다.

이후 재생에서는 음악 자체를 듣고 노래에서 자신의 위치를 찾고, 당신의 목소리를 실시간으로 추적합니다. 관대합니다: 한 옥타브 낮게 불러도 인정되며, 약간 늦어도 불이익이 없습니다.

시스템 요구 사항

Apple Silicon Mac(M1 이상)
macOS 14.2 이상
최신 릴리스에서 OnKey.dmg를 다운로드하여 응용 프로그램 폴더로 드래그하세요

설정 시 마이크 접근(목소리를 듣기 위해) 및 시스템 오디오 녹음(음악 앱을 듣기 위해)을 요청합니다. 듣기 전용 모드를 선택할 수 있으며, 이 경우 OnKey는 Spotify/Apple Music의 정보를 읽지 않고 소리만으로 노래를 따라갑니다.

개인정보 보호

OnKey는 듣는 음악을 절대 저장하지 않습니다 — 소리는 메모리에서만 분석합니다.
녹음과 학습된 노래는 Mac에 남아 있습니다. (스피커로 부른 테이크에는 음악이 일부 포함될 수 있습니다.)
계정 없음, 분석 없음, 충돌 보고 없음.

실제로 수행하는 네트워크 요청:

Shazam(Apple): 음악 앱이 재생 중인 곡을 알려주지 않을 때 곡명을 식별하기 위해 음악 앱 사운드의 짧은 서명(오디오가 아닌, 절대 마이크가 아닌)을 보냅니다.
LRCLIB: 가사를 가져오기 위해 아티스트, 제목, 앨범, 길이를 보냅니다.
iTunes Search/Lookup(Apple): 커버 및 곡 길이를 위해 사용합니다.
GitHub: 시작 1분 후와 하루에 한 번 업데이트를 확인합니다.

이 모든 것은 설정에서 끌 수 있습니다.

공정 사용

OnKey는 재생할 권리가 있는 음악으로 가정에서 연습하기 위한 것입니다. README는 사용자에게 다음을 요청합니다:

멜로디 전사를 비공개로 유지(공유하거나 게시하지 않음).
공유 기능을 사용하여 테이크를 공유 — 음악이 없는 목소리와 피치 라인의 짧은 비디오를 만들고, Instagram의 라이선스 음악 라이브러리에서 노래를 추가할 수 있습니다.
바나 이벤트에서는 라이선스된 노래방 서비스를 사용(OnKey의 가사는 무료 커뮤니티 데이터베이스에서 가져옴).
음악을 저장하기 위해 OnKey를 수정하지 않음.

권리 보유자는 hello@singonkey.app으로 작성자에게 연락할 수 있습니다.

소스에서 빌드

공식 빌드를 신뢰하지 않는다면 직접 복사본을 빌드할 수 있습니다. Xcode 명령줄 도구, Rust, Node, Python 3이 있는 Apple Silicon Mac이 필요합니다. README에 정확한 명령이 제공됩니다(클론, 종속성 설치, SHA-256 검증으로 모델 가져오기, 그런 다음 npx tauri build).

한 가지 제한 사항: 자체 빌드 버전은 Shazam에 새 노래 이름을 요청할 수 없습니다(작성자의 Apple 서명이 필요함). Spotify와 Apple Music은 재생 중인 곡을 자체적으로 보고하므로 YouTube 및 듣기 전용 모드에만 영향을 미칩니다.

공식 릴리스는 작성자의 Apple Developer ID로 서명되고 Apple이 공증합니다.

라이선스 및 크레딧

MIT 라이선스(LICENSE 참조).
수정 버전은 "OnKey"라고 부르거나 아이콘을 사용할 수 없습니다. 원본에 대한 크레딧은 감사히 여깁니다.
OnKey는 오디오 처리에 CREPE, GAME, wav2vec 2.0 및 UVR의 MDX-Net Karaoke 2를 사용합니다.
Daniel Murrell이 제작했습니다.

도움말

앱에는 문제 보고 옵션이 있으며, GitHub 이슈에 첨부할 숫자와 로그의 zip 파일(오디오나 녹음은 포함되지 않음)을 저장합니다. Discord 서버, 이메일 주소, 문제 해결 문서도 있습니다.

위의 모든 사실은 프로젝트의 README에서 직접 가져온 것입니다.