11 KiB
BetterLyrics
WinUI 3와 Win2D로 제작된 동적 가사 디스플레이 도구 — 로컬 재생 및 다양한 플레이어 지원
🎉 이 프로젝트는 SSPAI에 소개되었습니다!
기사 보기: BetterLyrics – Windows용 몰입감 있고 부드러운 가사 디스플레이 도구
🔈 피드백 및 채팅 그룹
QQ
Discord
Telegram🌟 주요 기능
-
🌠 아름다운 사용자 인터페이스
- 부드러운 애니메이션과 효과
-
↔️ 강력한 가사 번역
- 오프라인 기계 번역(30개 언어 지원)
- 로컬 가사 파일에서 내장 번역 자동 읽기
-
🧩 다양한 가사 소스
- 로컬 저장소
- 온라인 가사 제공자
- QQ Music
- NetEase Cloud Music(网易云音乐)
- Kugou Music(酷狗音乐)
- amll-ttml-db
- LRCLIB
-
🎶 다양한 음악 플레이어 지원
-
⚠️ NetEase Cloud Music
- 먼저 BetterNCM 플러그인을 설치하세요. 설치 후 다운그레이드 안내가 나오면 안내에 따라 NetEase Cloud Music을 2.10.13으로 다운그레이드하세요.
- 그 후 PluginMarket에서 InfLink 플러그인을 설치하고 NetEase Cloud Music을 재시작하세요.
- ⚠️ 플러그인 문제로 타임라인에 이슈가 있을 수 있습니다
-
⚠️ Kugou Music
- Kugou Music 설정에서 "시스템 재생 컨트롤(잠금 화면 등) 지원"을 켜세요
- Kugou Music은 타임라인 정보를 전송하지 않아, 재생 위치를 변경해도 BetterLyrics에서 감지할 수 없습니다
- ⚠️ 타임라인 문제는 Kugou 자체의 한계입니다
-
⚠️ Apple Music
- 설정의 "고급 옵션"에서 타임라인 임계값을 약 600ms로 설정하세요. 그렇지 않으면 가사가 계속 앞뒤로 흔들립니다.
- ⚠️ 가사 흔들림을 방지하려면 추가 설정이 필요합니다(자세한 내용은 문서 하단 FAQ 참조)
-
⚠️ foobar2000
- https://github.com/dumbie/foo_mediacontrol 을 설치하세요
- ⚠️ 플러그인 문제로 타임라인에 이슈가 있을 수 있습니다
-
Spotify
-
QQ Music
-
PotPlayer
-
미디어 플레이어(시스템)
-
LX Music
- LX Music 설정 페이지에서 "Open API"를 활성화하세요
- BetterLyrics 설정-고급 옵션에서 LX Music 서버 주소(보통 http://127.0.0.1:23330)를 입력하세요
-
MusicBee
-
iTunes
-
AIMP
-
-
🪟 다양한 표시 모드
- 표준 모드
- 몰입감 있는 가사 애니메이션과 동적 배경
- 도킹 모드
- 화면 가장자리에 고정되는 스마트 가사 바
- 데스크톱 모드
- 앱 위에 가사를 띄워서 표시
- 표준 모드
-
🧠 스마트 동작
- 음악이 일시정지되면 자동으로 숨김
본 프로젝트는 개발 중입니다. 최신 브랜치에는 버그나 예기치 않은 동작이 있을 수 있습니다.
스크린샷
표준 모드
도킹 모드
데스크톱 모드
데모
Bilibili에서 소개 영상을 시청하세요(2025년 7월 7일 업로드): 여기서 보기
지금 사용해보세요
Microsoft Store
가장 쉬운 설치 방법. 무제한 무료 체험 또는 구매(무료와 유료 버전 차이 없음)
☕ 유용하다면 Microsoft Store에서 구매로 응원해 주세요! 🥰
안정 버전이 출시되면 Microsoft Store가 가장 먼저 업데이트됩니다.
Google Drive
Google Drive에서도 다운로드할 수 있습니다(릴리즈 페이지 참조)
".zip" 파일을 다운로드합니다. 설치 방법은 이 문서를 참고하세요.
💖 특별 감사
- Lyricify-Lyrics-Helper
- QQ, NetEase, Kugou 가사 가져오기, 복호화, 파싱 지원
- lrclib
- LRCLIB 가사 API 제공자
- Audio Tools Library (ATL) for .NET
- 음악 파일에서 이미지 추출에 사용
- WinUIEx
- Win32 창 API에 쉽게 접근 가능
- TagLib#
- 원본 가사 내용 읽기에 사용
- Vanara
- Win32 API 래퍼
- LibreTranslate
- 오프라인 가사 번역 기능 제공
- Stackoverflow - WPF에서 Margin 속성 애니메이션 적용 방법
- DevWinUI
- Bilibili -【WinUI3】SystemBackdropController: 운모, 아크릴 효과 정의
- cnblogs - .NET 앱과 Windows 시스템 미디어 컨트롤(SMTC) 연동
- Win2D의 게임 루프: CanvasAnimatedControl
- r2d2rigo/Win2D-Samples
- CommunityToolkit - 입문부터 고급까지
영감 받은 프로젝트
✍️ 번역에 참여해 주세요
원하는 언어가 없나요? 걱정 마세요! 번역에 참여해 기여자가 되어 주세요! 😆 이 링크에서 Crowdin으로 번역에 참여할 수 있습니다.
Star 기록
이슈 및 PR 환영
버그를 발견하면 issues에 남겨주시고, 아이디어도 자유롭게 공유해 주세요.
FAQ
도킹 모드에서 버튼이 보이지 않아요
"도킹 모드"에 들어가면 동작 버튼이 숨겨집니다. 창 상단에 마우스를 올리면 "몰입", "더보기", "닫기" 버튼이 나타납니다.
창 하단 가장자리 바로 위에 마우스를 올리면 하단에 흰색 컨트롤 플로팅 창이 표시됩니다
"작은 흰색 바"를 클릭하면 하단 플로팅 컨트롤 바(재생 진행, 타임라인 오프셋 조정, 이전곡/일시정지/다음곡, 번역, 레이아웃, 설정 포함)가 표시됩니다
데스크톱 모드에서 창을 잠그는 방법
상단에 마우스를 올리고 자물쇠 아이콘을 클릭하거나 Ctrl + Alt + U를 누르세요.
데스크톱 모드에서 창 잠금 해제 방법
시스템 트레이 아이콘을 우클릭해 "창 잠금 해제"를 선택하거나 Ctrl + Alt + U를 누르세요.
가사 타임라인이 지연될 때
앱 맨 아래에 마우스를 올리세요.
첫 번째 아이콘 버튼(가사 타임라인 오프셋)을 클릭하면 오프셋을 자유롭게 조정할 수 있습니다.
가사가 자주 앞뒤로 움직여요(예: Apple Music)
"고급 옵션"에서 임계값(빨간 사각형 표시)을 늘리면 가사가 정상적으로 표시됩니다.