[_자주 묻는 질문(FAQ) 보러가기_](#faq)
BetterLyrics
[](https://github.com/jayfunc/BetterLyrics/blob/dev/README.zh-CN.md) [](https://github.com/jayfunc/BetterLyrics/blob/dev/README.zh-TW.md) [](https://github.com/jayfunc/BetterLyrics/blob/dev/README.ja.md) [](https://github.com/jayfunc/BetterLyrics/blob/dev/README.ko.md)
   
[](https://github.com/jayfunc/BetterLyrics/stargazers)
WinUI 3와 Win2D로 제작된 동적 가사 디스플레이 도구 — 로컬 재생 및 다양한 플레이어 지원
## 🎉 이 프로젝트는 SSPAI에 소개되었습니다!
기사 보기: [BetterLyrics – Windows용 몰입감 있고 부드러운 가사 디스플레이 도구](https://sspai.com/post/101028)
## 🔈 피드백 및 채팅 그룹
- [
QQ](https://qun.qq.com/universal-share/share?ac=1&authKey=4Q%2BYTq3wZldYpF5SbS5c19ECFsiYoLZFAIcBNNzYpBUtiEjaZ8sZ%2F%2BnFN0qw3lad&busi_data=eyJncm91cENvZGUiOiIxMDU0NzAwMzg4IiwidG9rZW4iOiJiVnhqemVYN0N5QVc3b1ZkR24wWmZOTUtvUkJoWm1JRWlaWW5iZnlBcXJtZUtGc2FFTHNlUlFZMi9iRm03cWF5IiwidWluIjoiMTM5NTczOTY2MCJ9&data=39UmAihyH_o6CZaOs7nk2mO_lz2ruODoDou6pxxh7utcxP4WF5sbDBDOPvZ_Wqfzeey4441anegsLYQJxkrBAA&svctype=4&tempid=h5_group_info) (1054700388)
- [
Discord](https://discord.gg/5yAQPnyCKv)
- [
Telegram](https://t.me/+svhSLZ7awPsxNGY1)
## 🌟 주요 기능
- 🌠 **아름다운 사용자 인터페이스**
- 부드러운 애니메이션과 효과
- ↔️ **강력한 가사 번역**
- 오프라인 기계 번역(30개 언어 지원)
- 로컬 가사 파일에서 내장 번역 자동 읽기
- 🧩 **다양한 가사 소스**
- 로컬 저장소
- 음악 파일(내장 가사 포함)
- [.lrc]() 파일(표준 및 확장 형식 지원)
- [.eslrc](https://github.com/ESLyric/release) 파일
- [.ttml](https://en.wikipedia.org/wiki/Timed_Text_Markup_Language) 파일
- 온라인 가사 제공자
- QQ Music
- NetEase Cloud Music(网易云音乐)
- Kugou Music(酷狗音乐)
- [amll-ttml-db](https://github.com/Steve-xmh/amll-ttml-db)
- [LRCLIB](https://lrclib.net/)
- 🎶 **다양한 음악 플레이어 지원**
- ⚠️ NetEase Cloud Music
- 먼저 [BetterNCM 플러그인](https://microblock.cc/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 을 설치하세요
- ⚠️ 플러그인 문제로 타임라인에 이슈가 있을 수 있습니다
LX Music
- LX Music 설정 페이지에서 "Open API"를 활성화하세요
- BetterLyrics 설정-고급 옵션에서 LX Music 서버 주소(보통 http://127.0.0.1:23330)를 입력하세요
MusicBee
- https://github.com/HenryPDT/mb_MediaControl 을 설치하세요
iTunes
- https://github.com/thewizrd/iTunes-SMTC 를 설치하세요
AIMP
- https://www.aimp.ru/?do=catalog&rec_id=1097 을 설치하세요
**가장 쉬운** 설치 방법. **무제한** 무료 체험 또는 구매(무료와 유료 버전 차이 없음)
☕ 유용하다면 **Microsoft Store**에서 구매로 응원해 주세요! 🥰
> 안정 버전이 출시되면 Microsoft Store가 가장 먼저 업데이트됩니다.
### Google Drive
Google Drive에서도 다운로드할 수 있습니다([릴리즈](https://github.com/jayfunc/BetterLyrics/releases) 페이지 참조)
> ".zip" 파일을 다운로드합니다. 설치 방법은 [이 문서](How2Install/How2Install.md)를 참고하세요.
## 💖 특별 감사
- [Lyricify-Lyrics-Helper](https://github.com/WXRIW/Lyricify-Lyrics-Helper)
- QQ, NetEase, Kugou 가사 가져오기, 복호화, 파싱 지원
- [lrclib](https://github.com/tranxuanthang/lrclib)
- LRCLIB 가사 API 제공자
- [Audio Tools Library (ATL) for .NET](https://github.com/Zeugma440/atldotnet)
- 음악 파일에서 이미지 추출에 사용
- [WinUIEx](https://github.com/dotMorten/WinUIEx)
- Win32 창 API에 쉽게 접근 가능
- [TagLib#](https://github.com/mono/taglib-sharp)
- 원본 가사 내용 읽기에 사용
- [Vanara](https://github.com/dahall/Vanara)
- Win32 API 래퍼
- [LibreTranslate](https://github.com/LibreTranslate/LibreTranslate)
- 오프라인 가사 번역 기능 제공
- [Stackoverflow - WPF에서 Margin 속성 애니메이션 적용 방법](https://stackoverflow.com/a/21542882/11048731)
- [DevWinUI](https://github.com/ghost1372/DevWinUI)
- [Bilibili -【WinUI3】SystemBackdropController: 운모, 아크릴 효과 정의](https://www.bilibili.com/video/BV1PY4FevEkS)
- [cnblogs - .NET 앱과 Windows 시스템 미디어 컨트롤(SMTC) 연동](https://www.cnblogs.com/TwilightLemon/p/18279496)
- [Win2D의 게임 루프: CanvasAnimatedControl](https://www.cnblogs.com/walterlv/p/10236395.html)
- [r2d2rigo/Win2D-Samples](https://github.com/r2d2rigo/Win2D-Samples/blob/master/IrisBlurWin2D/IrisBlurWin2D/MainPage.xaml.cs)
- [CommunityToolkit - 입문부터 고급까지](https://mvvm.coldwind.top/)
## 영감 받은 프로젝트
- [refined-now-playing-netease](https://github.com/solstice23/refined-now-playing-netease)
- [Lyricify-App](https://github.com/WXRIW/Lyricify-App)
- [소금 음악 Salt Player](https://moriafly.com/program/salt-player)
- [MyToolBar](https://github.com/TwilightLemon/MyToolBar)
## ✍️ 번역에 참여해 주세요
원하는 언어가 없나요?
걱정 마세요! 번역에 참여해 기여자가 되어 주세요! 😆
[이 링크](https://crowdin.com/project/betterlyrics/invite?h=d767e4f2dbd832d8fcdb6f7e5a198b402502866)에서 Crowdin으로 번역에 참여할 수 있습니다.
## Star 기록
[](https://www.star-history.com/#jayfunc/BetterLyrics&Date)
## 이슈 및 PR 환영
버그를 발견하면 issues에 남겨주시고, 아이디어도 자유롭게 공유해 주세요.
---
## FAQ
### 도킹 모드에서 버튼이 보이지 않아요
"도킹 모드"에 들어가면 동작 버튼이 숨겨집니다. 창 상단에 마우스를 올리면 "몰입", "더보기", "닫기" 버튼이 나타납니다.
창 하단 가장자리 바로 위에 마우스를 올리면 하단에 흰색 컨트롤 플로팅 창이 표시됩니다
"작은 흰색 바"를 클릭하면 하단 플로팅 컨트롤 바(재생 진행, 타임라인 오프셋 조정, 이전곡/일시정지/다음곡, 번역, 레이아웃, 설정 포함)가 표시됩니다
### 데스크톱 모드에서 창을 잠그는 방법
상단에 마우스를 올리고 자물쇠 아이콘을 클릭하거나 `Ctrl + Alt + U`를 누르세요.
### 데스크톱 모드에서 창 잠금 해제 방법
시스템 트레이 아이콘을 우클릭해 "창 잠금 해제"를 선택하거나 `Ctrl + Alt + U`를 누르세요.
### 가사 타임라인이 지연될 때
앱 맨 아래에 마우스를 올리세요.
첫 번째 아이콘 버튼(가사 타임라인 오프셋)을 클릭하면 오프셋을 자유롭게 조정할 수 있습니다.
### 가사가 자주 앞뒤로 움직여요(예: Apple Music)
"고급 옵션"에서 임계값(빨간 사각형 표시)을 늘리면 가사가 정상적으로 표시됩니다.
