elmgates/BetterLyrics
1
0
Fork 0
mirror of https://github.com/jayfunc/BetterLyrics.git synced 2026-01-13 03:34:55 +08:00
Code Issues Packages Projects Releases Wiki Activity

update readme

Browse Source
This commit is contained in:
Zhe Fang
2025-08-01 12:19:39 -04:00
parent 932f9d3a4f
commit 78edc2b3ce
1 changed files with 99 additions and 99 deletions
Download Patch File Download Diff File Expand all files Collapse all files

198
README.ko.md
View File

@@ -1,6 +1,6 @@
<div style="text-align: center;">
<div style="text-align: center;">
[? ?? ?? ??(FAQ) ????](#faq)
[❓ 자주 묻는 질문(FAQ) 보러가기](#faq)
</div>
@@ -25,115 +25,115 @@ BetterLyrics
</div>
<h4 align="center">
WinUI 3? Win2D? ??? ?? ?? ????? ?? <20><> ?? ?? ? ??? ???? ??
WinUI 3와 Win2D로 제작된 동적 가사 디스플레이 도구 — 로컬 재생 및 다양한 플레이어 지원
</h3>
## ?? ? ????? SSPAI? ???????!
## 🎉 이 프로젝트는 SSPAI에 소개되었습니다!
?? ??: [BetterLyrics <EFBFBD>C Windows? ??? ?? ???? ?? ????? ??](https://sspai.com/post/101028)
기사 보기: [BetterLyrics – Windows용 몰입감 있고 부드러운 가사 디스플레이 도구](https://sspai.com/post/101028)
## ?? ??? ? ?? ??
## 🔈 피드백 및 채팅 그룹
- [<img src="BetterLyrics.WinUI3\BetterLyrics.WinUI3\Assets\QQ.png" height="20"> 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)
- [<img src="BetterLyrics.WinUI3\BetterLyrics.WinUI3\Assets\Discord.png" height="12"> Discord](https://discord.gg/5yAQPnyCKv)
- [<img src="BetterLyrics.WinUI3\BetterLyrics.WinUI3\Assets\Telegram.png" height="16"> Telegram](https://t.me/+svhSLZ7awPsxNGY1)
## ?? ?? ??
## 🌟 주요 기능
- ?? **???? ??? ?????**
- ???? ?????? ??
- ?? **??? ?? ??**
- ???? ?? ??(30? ?? ??)
- ?? ?? ???? ?? ?? ?? ??
- ?? **??? ?? ??**
- ?? ???
- ?? ??(?? ?? ??)
- [.lrc](<https://en.wikipedia.org/wiki/LRC_(file_format)>) ??(?? ? ?? ?? ??)
- [.eslrc](https://github.com/ESLyric/release) ??
- [.ttml](https://en.wikipedia.org/wiki/Timed_Text_Markup_Language) ??
- ??? ?? ???
- 🌠 **아름다운 사용자 인터페이스**
- 부드러운 애니메이션과 효과
- ↔️ **강력한 가사 번역**
- 오프라인 기계 번역(30개 언어 지원)
- 로컬 가사 파일에서 내장 번역 자동 읽기
- 🧩 **다양한 가사 소스**
- 로컬 저장소
- 음악 파일(내장 가사 포함)
- [.lrc](<https://en.wikipedia.org/wiki/LRC_(file_format)>) 파일(표준 및 확장 형식 지원)
- [.eslrc](https://github.com/ESLyric/release) 파일
- [.ttml](https://en.wikipedia.org/wiki/Timed_Text_Markup_Language) 파일
- 온라인 가사 제공자
- QQ Music
- NetEase Cloud Music(<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>)
- Kugou Music(<EFBFBD>ṷ<EFBFBD><EFBFBD><EFBFBD><EFBFBD>)
- NetEase Cloud Music(网易云音乐)
- Kugou Music(酷狗音乐)
- [amll-ttml-db](https://github.com/Steve-xmh/amll-ttml-db)
- [LRCLIB](https://lrclib.net/)
- ?? **??? ?? ???? ??**
- 🎶 **다양한 음악 플레이어 지원**
- <details><summary>?? NetEase Cloud Music</summary>
- <details><summary>⚠️ NetEase Cloud Music</summary>
- ?? [BetterNCM ????](https://microblock.cc/betterncm)? ?????. ?? ? ?????? ??? ??? ??? ?? NetEase Cloud Music? 2.10.13?? ?????????.
- ? ? PluginMarket?? InfLink ????? ???? NetEase Cloud Music? ??????.
- ?? ???? ??? ????? ??? ?? ? ????
- 먼저 [BetterNCM 플러그인](https://microblock.cc/betterncm)을 설치하세요. 설치 후 다운그레이드 안내가 나오면 안내에 따라 NetEase Cloud Music을 2.10.13으로 다운그레이드하세요.
- 그 후 PluginMarket에서 InfLink 플러그인을 설치하고 NetEase Cloud Music을 재시작하세요.
- ⚠️ 플러그인 문제로 타임라인에 이슈가 있을 수 있습니다
</details>
- <details><summary>?? Kugou Music</summary>
- <details><summary>⚠️ Kugou Music</summary>
- Kugou Music ???? "??? ?? ???(?? ?? ?) ??"? ???
- Kugou Music? ???? ??? ???? ??, ?? ??? ???? BetterLyrics?? ??? ? ????
- ?? ???? ??? Kugou ??? ?????
- Kugou Music 설정에서 "시스템 재생 컨트롤(잠금 화면 등) 지원"을 켜세요
- Kugou Music은 타임라인 정보를 전송하지 않아, 재생 위치를 변경해도 BetterLyrics에서 감지할 수 없습니다
- ⚠️ 타임라인 문제는 Kugou 자체의 한계입니다
</details>
- <details><summary>?? Apple Music</summary>
- <details><summary>⚠️ Apple Music</summary>
- ??? "?? ??"?? ???? ???? ? 600ms? ?????. ??? ??? ??? ?? ??? ?????.
- ?? ?? ???? ????? ?? ??? ?????(??? ??? ?? ?? FAQ ??)
- 설정의 "고급 옵션"에서 타임라인 임계값을 약 600ms로 설정하세요. 그렇지 않으면 가사가 계속 앞뒤로 흔들립니다.
- ⚠️ 가사 흔들림을 방지하려면 추가 설정이 필요합니다(자세한 내용은 문서 하단 FAQ 참조)
</details>
- <details><summary>?? foobar2000</summary>
- <details><summary>⚠️ foobar2000</summary>
- https://github.com/dumbie/foo_mediacontrol ? ?????
- ?? ???? ??? ????? ??? ?? ? ????
- https://github.com/dumbie/foo_mediacontrol 을 설치하세요
- ⚠️ 플러그인 문제로 타임라인에 이슈가 있을 수 있습니다
</details>
- Spotify
- QQ Music
- PotPlayer
- ??? ????(???)
- 미디어 플레이어(시스템)
- <details><summary>LX Music</summary>
- LX Music ?? ????? "Open API"? ??????
- BetterLyrics ??-?? ???? LX Music ?? ??(?? http://127.0.0.1:23330)? ?????
- LX Music 설정 페이지에서 "Open API"를 활성화하세요
- BetterLyrics 설정-고급 옵션에서 LX Music 서버 주소(보통 http://127.0.0.1:23330)를 입력하세요
</details>
- <details><summary>MusicBee</summary>
- https://github.com/HenryPDT/mb_MediaControl ? ?????
- https://github.com/HenryPDT/mb_MediaControl 을 설치하세요
</details>
- <details><summary>iTunes</summary>
- https://github.com/thewizrd/iTunes-SMTC ? ?????
- https://github.com/thewizrd/iTunes-SMTC 를 설치하세요
</details>
- <details><summary>AIMP</summary>
- https://www.aimp.ru/?do=catalog&rec_id=1097 ? ?????
- https://www.aimp.ru/?do=catalog&rec_id=1097 을 설치하세요
</details>
- ?? **??? ?? ??**
- **?? ??**
- ??? ?? ?? ?????? ?? ??
- **?? ??**
- ?? ????? ???? ??? ?? ?
- **???? ??**
- ? ?? ??? ??? ??
- ?? **??? ??**
- ??? ?????? ???? ??
- 🪟 **다양한 표시 모드**
- **표준 모드**
- 몰입감 있는 가사 애니메이션과 동적 배경
- **도킹 모드**
- 화면 가장자리에 고정되는 스마트 가사 바
- **데스크톱 모드**
- 앱 위에 가사를 띄워서 표시
- 🧠 **스마트 동작**
- 음악이 일시정지되면 자동으로 숨김
> ? ????? ?? ????. ?? ????? ??? ??? ?? ??? ?? ? ????.
> 본 프로젝트는 개발 중입니다. 최신 브랜치에는 버그나 예기치 않은 동작이 있을 수 있습니다.
## ????
## 스크린샷
### ?? ??
### 표준 모드
![alt text](Screenshots/image.png)
@@ -145,23 +145,23 @@ WinUI 3? Win2D? ??? ?? ?? ????? ??
![alt text](Screenshots/album-art-only.png)
### ?? ??
### 도킹 모드
![alt text](Screenshots/dock-1.png)
![alt text](Screenshots/dock-2.png)
### ???? ??
### 데스크톱 모드
![alt text](Screenshots/desktop-1.png)
![alt text](Screenshots/desktop-2.png)
## ??
## 데모
Bilibili?? ?? ??? ?????(2025? 7? 7? ???): [??? ??](https://www.bilibili.com/video/BV1zjGjzfEXh)
Bilibili에서 소개 영상을 시청하세요(2025년 7월 7일 업로드): [여기서 보기](https://www.bilibili.com/video/BV1zjGjzfEXh)
## ?? ??????
## 지금 사용해보세요
### Microsoft Store
@@ -169,103 +169,103 @@ Bilibili?? ?? ??? ?????(2025? 7? 7? ???): [??? ??](https://www.bilibili.com/vide
<img src="https://get.microsoft.com/images/en-us%20dark.svg" width="200"/>
</a>
**?? ??** ?? ??. **???** ?? ?? ?? ??(??? ?? ?? ?? ??)
**가장 쉬운** 설치 방법. **무제한** 무료 체험 또는 구매(무료와 유료 버전 차이 없음)
? ????? **Microsoft Store**?? ??? ??? ???! ??
☕ 유용하다면 **Microsoft Store**에서 구매로 응원해 주세요! 🥰
> ?? ??? ???? Microsoft Store? ?? ?? ???????.
> 안정 버전이 출시되면 Microsoft Store가 가장 먼저 업데이트됩니다.
### Google Drive
Google Drive??? ????? ? ????([???](https://github.com/jayfunc/BetterLyrics/releases) ??? ??)
Google Drive에서도 다운로드할 수 있습니다([릴리즈](https://github.com/jayfunc/BetterLyrics/releases) 페이지 참조)
> ".zip" ??? ???????. ?? ??? [? ??](How2Install/How2Install.md)? ?????.
> ".zip" 파일을 다운로드합니다. 설치 방법은 [이 문서](How2Install/How2Install.md)를 참고하세요.
## ?? ?? ??
## 💖 특별 감사
- [Lyricify-Lyrics-Helper](https://github.com/WXRIW/Lyricify-Lyrics-Helper)
- QQ, NetEase, Kugou ?? ????, ???, ?? ??
- QQ, NetEase, Kugou 가사 가져오기, 복호화, 파싱 지원
- [lrclib](https://github.com/tranxuanthang/lrclib)
- LRCLIB ?? API ???
- LRCLIB 가사 API 제공자
- [Audio Tools Library (ATL) for .NET](https://github.com/Zeugma440/atldotnet)
- ?? ???? ??? ??? ??
- 음악 파일에서 이미지 추출에 사용
- [WinUIEx](https://github.com/dotMorten/WinUIEx)
- Win32 ? API? ?? ?? ??
- Win32 창 API에 쉽게 접근 가능
- [TagLib#](https://github.com/mono/taglib-sharp)
- ?? ?? ?? ??? ??
- 원본 가사 내용 읽기에 사용
- [Vanara](https://github.com/dahall/Vanara)
- Win32 API ??
- Win32 API 래퍼
- [LibreTranslate](https://github.com/LibreTranslate/LibreTranslate)
- ???? ?? ?? ?? ??
- [Stackoverflow - WPF?? Margin ?? ????? ?? ??](https://stackoverflow.com/a/21542882/11048731)
- 오프라인 가사 번역 기능 제공
- [Stackoverflow - WPF에서 Margin 속성 애니메이션 적용 방법](https://stackoverflow.com/a/21542882/11048731)
- [DevWinUI](https://github.com/ghost1372/DevWinUI)
- [Bilibili -<EFBFBD><EFBFBD>WinUI3<EFBFBD><EFBFBD>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)
- [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/)
- [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)
- [소금 음악 Salt Player](https://moriafly.com/program/salt-player)
- [MyToolBar](https://github.com/TwilightLemon/MyToolBar)
## ?? ??? ??? ???
## ✍️ 번역에 참여해 주세요
??? ??? ????
?? ???! ??? ??? ???? ?? ???! ??
[? ??](https://crowdin.com/project/betterlyrics/invite?h=d767e4f2dbd832d8fcdb6f7e5a198b402502866)?? Crowdin?? ??? ??? ? ????.
원하는 언어가 없나요?
걱정 마세요! 번역에 참여해 기여자가 되어 주세요! 😆
[이 링크](https://crowdin.com/project/betterlyrics/invite?h=d767e4f2dbd832d8fcdb6f7e5a198b402502866)에서 Crowdin으로 번역에 참여할 수 있습니다.
## Star ??
## Star 기록
[![](https://api.star-history.com/svg?repos=jayfunc/BetterLyrics&type=Date)](https://www.star-history.com/#jayfunc/BetterLyrics&Date)
## ?? ? PR ??
## 이슈 및 PR 환영
??? ???? issues? ?????, ????? ???? ??? ???.
버그를 발견하면 issues에 남겨주시고, 아이디어도 자유롭게 공유해 주세요.
---
## FAQ
### ?? ???? ??? ??? ???
### 도킹 모드에서 버튼이 보이지 않아요
"?? ??"? ???? ?? ??? ?????. ? ??? ???? ??? "??", "???", "??" ??? ?????.
"도킹 모드"에 들어가면 동작 버튼이 숨겨집니다. 창 상단에 마우스를 올리면 "몰입", "더보기", "닫기" 버튼이 나타납니다.
![alt text](FAQ/image-10.png)
? ?? ???? ?? ?? ???? ??? ??? ?? ??? ??? ?? ?????
창 하단 가장자리 바로 위에 마우스를 올리면 하단에 흰색 컨트롤 플로팅 창이 표시됩니다
![alt text](FAQ/image-11.png)
"?? ?? ?"? ???? ?? ??? ??? ?(?? ??, ???? ??? ??, ???/????/???, ??, ????, ?? ??)? ?????
"작은 흰색 바"를 클릭하면 하단 플로팅 컨트롤 바(재생 진행, 타임라인 오프셋 조정, 이전곡/일시정지/다음곡, 번역, 레이아웃, 설정 포함)가 표시됩니다
![alt text](FAQ/image-12.png)
### ???? ???? ?? ??? ??
### 데스크톱 모드에서 창을 잠그는 방법
![alt text](FAQ/image-6.png)
??? ???? ??? ??? ???? ????? `Ctrl + Alt + U`? ????.
상단에 마우스를 올리고 자물쇠 아이콘을 클릭하거나 `Ctrl + Alt + U`를 누르세요.
### ???? ???? ? ?? ?? ??
### 데스크톱 모드에서 창 잠금 해제 방법
![alt text](FAQ/image-7.png)
??? ??? ???? ???? "? ?? ??"? ????? `Ctrl + Alt + U`? ????.
시스템 트레이 아이콘을 우클릭해 "창 잠금 해제"를 선택하거나 `Ctrl + Alt + U`를 누르세요.
### ?? ????? ??? ?
### 가사 타임라인이 지연될 때
? ? ??? ???? ????.
앱 맨 아래에 마우스를 올리세요.
![alt text](FAQ/image.png)
? ?? ??? ??(?? ???? ???)? ???? ???? ???? ??? ? ????.
첫 번째 아이콘 버튼(가사 타임라인 오프셋)을 클릭하면 오프셋을 자유롭게 조정할 수 있습니다.
### ??? ?? ??? ????(?: Apple Music)
### 가사가 자주 앞뒤로 움직여요(예: Apple Music)
![alt text](FAQ/image-2.png)
"?? ??"?? ???(?? ??? ??)? ??? ??? ????? ?????.
"고급 옵션"에서 임계값(빨간 사각형 표시)을 늘리면 가사가 정상적으로 표시됩니다.