update docs

This commit is contained in:
Zhe Fang
2025-08-22 15:00:57 -04:00
parent 2f9fa02214
commit 92a6fe46de
27 changed files with 37 additions and 1178 deletions

View File

@@ -1,14 +1,34 @@
## FAQ has been moved ### Where I can find the logs?
[Click here to visit](https://github.com/jayfunc/BetterLyrics?tab=readme-ov-file#faq) C:\Users\%USERNAME%\AppData\Local\Packages\37412.BetterLyrics_c8mj3v9sysxb4\LocalCache\logs
## FAQ 现已迁移 ### How to install ".msixbundle" package?
[点此访问](https://github.com/jayfunc/BetterLyrics/blob/dev/README.zh-CN.md#faq) [See this doc](https://github.com/jayfunc/BetterLyrics/blob/dev/How2Install/How2Install.md)
## FAQ 已移至新位置 ### Lyrics are moving back and forth constantly, how to fix it?
[點此前往](https://github.com/jayfunc/BetterLyrics/blob/dev/README.zh-TW.md#faq) ![](Snipaste_2025-08-22_14-59-53.png)
## FAQ は移動しました Go to Settings > Playback sources > Disable "Lyrics timeline sync" or increase "Lyrics timeline sync threshold"
[こちらをクリック](https://github.com/jayfunc/BetterLyrics/blob/dev/README.ja.md#faq)
## FAQ가 이동되었습니다 ### Wrong lyrics are shown, how to fix it?
[여기를 클릭하세요](https://github.com/jayfunc/BetterLyrics/blob/dev/README.ko.md#faq) ![](Snipaste_2025-08-22_14-47-21.png)
Open search panel to manually search for the correct lyrics.
### Playback control panel is not showing in dock mode, how to fix it?
![](Snipaste_2025-08-22_14-50-16.png)
Hover over the bottom of the lyrics window and click on the white line to show the playback control panel.
### How to lock/unlock the lyrics window in desktop mode?
![](Snipaste_2025-08-22_14-52-53.png)
![](Snipaste_2025-08-22_14-53-21.png)
Alternatively, you can also use the shortcut `Ctrl+Alt+U` (default) to toggle lock/unlock.
![](Snipaste_2025-08-22_14-53-58.png)
You can change the shortcut in Settings > App appearance and behavior > Unlock and lock shortcut keys
### How to enable/disable immersive mode?
![](Snipaste_2025-08-22_14-58-44.png)

Binary file not shown.

After

Width:  |  Height:  |  Size: 151 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 33 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 34 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 36 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 148 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 157 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 79 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 510 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 224 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 221 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 367 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 66 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 631 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 599 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 859 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 854 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 139 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 1.1 MiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 250 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 445 KiB

View File

@@ -1,2 +1 @@
## 简体中文文档现已迁移 [原页面已更改,点此返回项目主页](https://github.com/jayfunc/BetterLyrics)
[点此访问](https://github.com/jayfunc/BetterLyrics/blob/dev/README.zh-CN.md)

View File

@@ -1,275 +0,0 @@
[_よくある質問FAQはこちらをクリック_](#faq)
![](Promotion/banner.png)
<div align=center>
<img src="BetterLyrics.WinUI3/BetterLyrics.WinUI3/Assets/Logo.png" alt="" width="64">
</div>
<h2 align=center>
BetterLyrics
</h2>
<div align=center>
[![](https://img.shields.io/badge/zh--CN-%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87-blue)](https://github.com/jayfunc/BetterLyrics/blob/dev/README.zh-CN.md) [![Static Badge](https://img.shields.io/badge/zh--TW-%E7%B9%81%E9%AB%94%E4%B8%AD%E6%96%87-blue)](https://github.com/jayfunc/BetterLyrics/blob/dev/README.zh-TW.md) [![Static Badge](https://img.shields.io/badge/ja-%E6%97%A5%E6%9C%AC%E8%AA%9E-blue)](https://github.com/jayfunc/BetterLyrics/blob/dev/README.ja.md) [![Static Badge](https://img.shields.io/badge/ko-%ED%95%9C%EA%B5%AD%EC%9D%B8-blue)](https://github.com/jayfunc/BetterLyrics/blob/dev/README.ko.md)
</div>
<div align=center>
![Static Badge](https://img.shields.io/badge/Language-C%23-purple) ![Static Badge](https://img.shields.io/badge/License-MIT-red) ![Static Badge](https://img.shields.io/badge/IDE-Visual%20Studio-purple) ![Static Badge](https://img.shields.io/badge/Framework-WinUI%203-blue)
</div>
<div align=center>
[![GitHub Repo stars](https://img.shields.io/github/stars/jayfunc/BetterLyrics)](https://github.com/jayfunc/BetterLyrics/stargazers)
</div>
<h4 align="center">
WinUI 3とWin2Dで構築された動的歌詞表示ツール — ローカル再生や他のプレーヤーにも対応
</h3>
## 🎉 本プロジェクトはSSPAIで特集されました
記事はこちら:[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) ファイル
- オンライン歌詞プロバイダー
- QQ Music
- 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>
- まず[BetterNCMプラグイン](https://microblock.cc/betterncm)をインストールしてください。インストール後にダウングレード案内が表示された場合は、案内に従いNetEase Cloud Musicを2.10.13にダウングレードしてください。
- その後、PluginMarketでInfLinkプラグインをインストールし、NetEase Cloud Musicを再起動してください。
- ⚠️ プラグインの問題によりタイムラインに不具合がある場合があります
</details>
- <details><summary>⚠️ Kugou Music</summary>
- Kugou Musicの設定で「システム再生コントロールロック画面などをサポート」を有効にしてください
- Kugou Musicはタイムライン情報を送信しないため、再生位置を変更してもBetterLyricsは検出できません
- ⚠️ タイムラインの問題はKugou自体の制限です
</details>
- <details><summary>⚠️ Apple Music</summary>
- 設定の「詳細オプション」でタイムラインしきい値を約600msに設定してください。そうしないと歌詞が前後に揺れ続けます。
- ⚠️ 歌詞の揺れを防ぐには追加設定が必要です詳細は末尾FAQ参照
</details>
- <details><summary>⚠️ foobar2000</summary>
- 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を入力してください
</details>
- <details><summary>MusicBee</summary>
- https://github.com/HenryPDT/mb_MediaControl をインストールしてください
</details>
- <details><summary>iTunes</summary>
- https://github.com/thewizrd/iTunes-SMTC をインストールしてください
</details>
- <details><summary>AIMP</summary>
- https://www.aimp.ru/?do=catalog&rec_id=1097 をインストールしてください
</details>
- 🪟 **多様な表示モード**
- **標準モード**
- 没入感のある歌詞アニメーションと動的背景
- **ドックモード**
- 画面端に固定されるスマートな歌詞バー
- **デスクトップモード**
- アプリの上に歌詞をフロート表示
- 🧠 **スマートな動作**
- 音楽が一時停止すると自動的に非表示
> 本プロジェクトは開発中です。最新ブランチにはバグや予期しない動作が含まれる場合があります。
## スクリーンショット
### 標準モード
![alt text](Screenshots/image.png)
![alt text](Screenshots/glow-float.gif)
![alt text](Screenshots/fan.png)
![alt text](Screenshots/lyrics-only.png)
![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年8月18日アップロード[こちら](https://www.bilibili.com/video/BV1yLYtzQEME/)
## 今すぐ試す
### Microsoft Store
<a href="https://apps.microsoft.com/detail/9P1WCD1P597R?referrer=appbadge&mode=direct">
<img src="https://get.microsoft.com/images/en-us%20dark.svg" width="200"/>
</a>
**最も簡単**な入手方法。**無制限**の無料トライアルまたは購入(無料版と有料版の違いはありません)
☕ 役に立ったら、ぜひ **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://api.star-history.com/svg?repos=jayfunc/BetterLyrics&type=Date)](https://www.star-history.com/#jayfunc/BetterLyrics&Date)
## 不具合・PR歓迎
バグを見つけた場合は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` を押してください。
### デスクトップモードでウィンドウのロックを解除する方法
![alt text](FAQ/image-7.png)
システムトレイのアイコンを右クリックし、「ウィンドウのロック解除」を選択、または `Ctrl + Alt + U` を押してください。
### 歌詞のタイムラインに遅延がある
アプリの一番下にマウスを重ねてください。
![alt text](FAQ/image.png)
最初のアイコンボタン(歌詞タイムラインオフセット)をクリックすると、オフセットを自由に調整できます。
### 歌詞が頻繁に前後にジャンプするApple Music
![alt text](FAQ/image-2.png)
「詳細オプション」セクションでしきい値(赤い四角でマーク)を上げると、歌詞が正常に動作します。

View File

@@ -1,275 +0,0 @@
[_자주 묻는 질문(FAQ) 보러가기_](#faq)
![](Promotion/banner.png)
<div align=center>
<img src="BetterLyrics.WinUI3/BetterLyrics.WinUI3/Assets/Logo.png" alt="" width="64">
</div>
<h2 align=center>
BetterLyrics
</h2>
<div align=center>
[![](https://img.shields.io/badge/zh--CN-%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87-blue)](https://github.com/jayfunc/BetterLyrics/blob/dev/README.zh-CN.md) [![Static Badge](https://img.shields.io/badge/zh--TW-%E7%B9%81%E9%AB%94%E4%B8%AD%E6%96%87-blue)](https://github.com/jayfunc/BetterLyrics/blob/dev/README.zh-TW.md) [![Static Badge](https://img.shields.io/badge/ja-%E6%97%A5%E6%9C%AC%E8%AA%9E-blue)](https://github.com/jayfunc/BetterLyrics/blob/dev/README.ja.md) [![Static Badge](https://img.shields.io/badge/ko-%ED%95%9C%EA%B5%AD%EC%9D%B8-blue)](https://github.com/jayfunc/BetterLyrics/blob/dev/README.ko.md)
</div>
<div align=center>
![Static Badge](https://img.shields.io/badge/Language-C%23-purple) ![Static Badge](https://img.shields.io/badge/License-MIT-red) ![Static Badge](https://img.shields.io/badge/IDE-Visual%20Studio-purple) ![Static Badge](https://img.shields.io/badge/Framework-WinUI%203-blue)
</div>
<div align=center>
[![GitHub Repo stars](https://img.shields.io/github/stars/jayfunc/BetterLyrics)](https://github.com/jayfunc/BetterLyrics/stargazers)
</div>
<h4 align="center">
WinUI 3와 Win2D로 제작된 동적 가사 디스플레이 도구 — 로컬 재생 및 다양한 플레이어 지원
</h3>
## 🎉 이 프로젝트는 SSPAI에 소개되었습니다!
기사 보기: [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) 파일
- 온라인 가사 제공자
- QQ Music
- 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>
- 먼저 [BetterNCM 플러그인](https://microblock.cc/betterncm)을 설치하세요. 설치 후 다운그레이드 안내가 나오면 안내에 따라 NetEase Cloud Music을 2.10.13으로 다운그레이드하세요.
- 그 후 PluginMarket에서 InfLink 플러그인을 설치하고 NetEase Cloud Music을 재시작하세요.
- ⚠️ 플러그인 문제로 타임라인에 이슈가 있을 수 있습니다
</details>
- <details><summary>⚠️ Kugou Music</summary>
- Kugou Music 설정에서 "시스템 재생 컨트롤(잠금 화면 등) 지원"을 켜세요
- Kugou Music은 타임라인 정보를 전송하지 않아, 재생 위치를 변경해도 BetterLyrics에서 감지할 수 없습니다
- ⚠️ 타임라인 문제는 Kugou 자체의 한계입니다
</details>
- <details><summary>⚠️ Apple Music</summary>
- 설정의 "고급 옵션"에서 타임라인 임계값을 약 600ms로 설정하세요. 그렇지 않으면 가사가 계속 앞뒤로 흔들립니다.
- ⚠️ 가사 흔들림을 방지하려면 추가 설정이 필요합니다(자세한 내용은 문서 하단 FAQ 참조)
</details>
- <details><summary>⚠️ foobar2000</summary>
- 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)를 입력하세요
</details>
- <details><summary>MusicBee</summary>
- https://github.com/HenryPDT/mb_MediaControl 을 설치하세요
</details>
- <details><summary>iTunes</summary>
- https://github.com/thewizrd/iTunes-SMTC 를 설치하세요
</details>
- <details><summary>AIMP</summary>
- https://www.aimp.ru/?do=catalog&rec_id=1097 을 설치하세요
</details>
- 🪟 **다양한 표시 모드**
- **표준 모드**
- 몰입감 있는 가사 애니메이션과 동적 배경
- **도킹 모드**
- 화면 가장자리에 고정되는 스마트 가사 바
- **데스크톱 모드**
- 앱 위에 가사를 띄워서 표시
- 🧠 **스마트 동작**
- 음악이 일시정지되면 자동으로 숨김
> 본 프로젝트는 개발 중입니다. 최신 브랜치에는 버그나 예기치 않은 동작이 있을 수 있습니다.
## 스크린샷
### 표준 모드
![alt text](Screenshots/image.png)
![alt text](Screenshots/glow-float.gif)
![alt text](Screenshots/fan.png)
![alt text](Screenshots/lyrics-only.png)
![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년 8월 18일 업로드): [여기서 보기](https://www.bilibili.com/video/BV1yLYtzQEME/)
## 지금 사용해보세요
### Microsoft Store
<a href="https://apps.microsoft.com/detail/9P1WCD1P597R?referrer=appbadge&mode=direct">
<img src="https://get.microsoft.com/images/en-us%20dark.svg" width="200"/>
</a>
**가장 쉬운** 설치 방법. **무제한** 무료 체험 또는 구매(무료와 유료 버전 차이 없음)
☕ 유용하다면 **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://api.star-history.com/svg?repos=jayfunc/BetterLyrics&type=Date)](https://www.star-history.com/#jayfunc/BetterLyrics&Date)
## 이슈 및 PR 환영
버그를 발견하면 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`를 누르세요.
### 데스크톱 모드에서 창 잠금 해제 방법
![alt text](FAQ/image-7.png)
시스템 트레이 아이콘을 우클릭해 "창 잠금 해제"를 선택하거나 `Ctrl + Alt + U`를 누르세요.
### 가사 타임라인이 지연될 때
앱 맨 아래에 마우스를 올리세요.
![alt text](FAQ/image.png)
첫 번째 아이콘 버튼(가사 타임라인 오프셋)을 클릭하면 오프셋을 자유롭게 조정할 수 있습니다.
### 가사가 자주 앞뒤로 움직여요(예: Apple Music)
![alt text](FAQ/image-2.png)
"고급 옵션"에서 임계값(빨간 사각형 표시)을 늘리면 가사가 정상적으로 표시됩니다.

View File

@@ -1,4 +1,4 @@
[_Click here to view frequently asked questions (FAQ)_](#faq) [_Click here to view frequently asked questions (FAQ)_](https://github.com/jayfunc/BetterLyrics/blob/dev/FAQ/FAQ.md)
![](Promotion/banner.png) ![](Promotion/banner.png)
@@ -12,12 +12,6 @@ BetterLyrics
<div align=center> <div align=center>
[![](https://img.shields.io/badge/zh--CN-%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87-blue)](https://github.com/jayfunc/BetterLyrics/blob/dev/README.zh-CN.md) [![Static Badge](https://img.shields.io/badge/zh--TW-%E7%B9%81%E9%AB%94%E4%B8%AD%E6%96%87-blue)](https://github.com/jayfunc/BetterLyrics/blob/dev/README.zh-TW.md) [![Static Badge](https://img.shields.io/badge/ja-%E6%97%A5%E6%9C%AC%E8%AA%9E-blue)](https://github.com/jayfunc/BetterLyrics/blob/dev/README.ja.md) [![Static Badge](https://img.shields.io/badge/ko-%ED%95%9C%EA%B5%AD%EC%9D%B8-blue)](https://github.com/jayfunc/BetterLyrics/blob/dev/README.ko.md)
</div>
<div align=center>
![Static Badge](https://img.shields.io/badge/Language-C%23-purple) ![Static Badge](https://img.shields.io/badge/License-MIT-red) ![Static Badge](https://img.shields.io/badge/IDE-Visual%20Studio-purple) ![Static Badge](https://img.shields.io/badge/Framework-WinUI%203-blue) ![Static Badge](https://img.shields.io/badge/Language-C%23-purple) ![Static Badge](https://img.shields.io/badge/License-MIT-red) ![Static Badge](https://img.shields.io/badge/IDE-Visual%20Studio-purple) ![Static Badge](https://img.shields.io/badge/Framework-WinUI%203-blue)
</div> </div>
@@ -56,9 +50,9 @@ Check out the article: [BetterLyrics An immersive and smooth lyrics display
- [.eslrc](https://github.com/ESLyric/release) files - [.eslrc](https://github.com/ESLyric/release) files
- [.ttml](https://en.wikipedia.org/wiki/Timed_Text_Markup_Language) files - [.ttml](https://en.wikipedia.org/wiki/Timed_Text_Markup_Language) files
- Online lyrics providers - Online lyrics providers
- QQ Music - QQ 音乐
- 网易云音乐 NetEase Cloud Music - 网易云音乐
- 酷狗音乐 Kugou Music - 酷狗音乐
- [amll-ttml-db](https://github.com/Steve-xmh/amll-ttml-db) - [amll-ttml-db](https://github.com/Steve-xmh/amll-ttml-db)
- [LRCLIB](https://lrclib.net/) - [LRCLIB](https://lrclib.net/)
- 🎶 **Multiple Music Players Supported** - 🎶 **Multiple Music Players Supported**
@@ -79,13 +73,6 @@ Check out the article: [BetterLyrics An immersive and smooth lyrics display
</details> </details>
- <details><summary>⚠️ Apple Music</summary>
- Make sure you have set timeline threshold to around 600 ms in settings (Go to "Settings" - "Advanced option" to change), otherwise, the lyrics will be moving forward and afterward constantly.
- ⚠️ Please note that you need additional settings to stop from seeing shaking lyrics (see FAQ at the end of this document for more information)
</details>
- <details><summary>⚠️ foobar2000</summary> - <details><summary>⚠️ foobar2000</summary>
- Make sure you have https://github.com/dumbie/foo_mediacontrol installed with it - Make sure you have https://github.com/dumbie/foo_mediacontrol installed with it
@@ -93,6 +80,7 @@ Check out the article: [BetterLyrics An immersive and smooth lyrics display
</details> </details>
- Apple Music
- Spotify - Spotify
- QQ Music - QQ Music
- PotPlayer - PotPlayer
@@ -228,48 +216,4 @@ Click the [link](https://crowdin.com/project/betterlyrics/invite?h=d767e4f2dbd83
## Any issues and PRs are welcomed ## Any issues and PRs are welcomed
If you find a bug please file it in issues or if you have any ideas feel free to share it here. If you find a bug please file it in issues or if you have any ideas feel free to share it here.
---
## FAQ
### I couldn't see any button in dock mode
It is important to note that when you enter "Docked Mode", the action buttons are hidden. Hover your mouse over the top to access the "Immerse", "More", and "Close" buttons.
![alt text](FAQ/image-10.png)
Hover the mouse slightly above the bottom edge of the window to display the white control floating window at the bottom
![alt text](FAQ/image-11.png)
Tap the "little white bar" to display the bottom control bar in floating window form (including current playback progress view, timeline offset adjustment; previous song, pause/play, next song; translation, layout, settings)
![alt text](FAQ/image-12.png)
### How can I lock the window in desktop mode
![alt text](FAQ/image-6.png)
Hover you mouse on the top, click on the lock icon and you're good to go! Or, alternatively, press `Ctrl + Alt + U`.
### How can I unlock the window in desktop mode
![alt text](FAQ/image-7.png)
It's in the system tray, right-click on the icon and you'll see "Unlock the window". Or, alternatively, press `Ctrl + Alt + U`.
### There's a delay in lyrics timeline
Hover you mouse on the very bottom of the app,
![alt text](FAQ/image.png)
And then click on the first icon button (Lyrics timeline offset), here you can adjust the offset freely.
### The lyrics jump back and forth frequently (e.g. Apple Music)
![alt text](FAQ/image-2.png)
Go to "Advanced options" section, increase the threshold value (marked with the bigger red rectangle) until the lyrics is working properly.

View File

@@ -1,279 +0,0 @@
[_点击此处查看常见问题_](#faq)
![](Promotion/banner.png)
<div align=center>
</div>
<div align=center>
<img src="BetterLyrics.WinUI3/BetterLyrics.WinUI3/Assets/Logo.png" alt="" width="64">
</div>
<h2 align=center>
BetterLyrics
</h2>
<div align=center>
[![](https://img.shields.io/badge/zh--CN-%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87-blue)](https://github.com/jayfunc/BetterLyrics/blob/dev/README.zh-CN.md) [![Static Badge](https://img.shields.io/badge/zh--TW-%E7%B9%81%E9%AB%94%E4%B8%AD%E6%96%87-blue)](https://github.com/jayfunc/BetterLyrics/blob/dev/README.zh-TW.md) [![Static Badge](https://img.shields.io/badge/ja-%E6%97%A5%E6%9C%AC%E8%AA%9E-blue)](https://github.com/jayfunc/BetterLyrics/blob/dev/README.ja.md) [![Static Badge](https://img.shields.io/badge/ko-%ED%95%9C%EA%B5%AD%EC%9D%B8-blue)](https://github.com/jayfunc/BetterLyrics/blob/dev/README.ko.md)
</div>
<div align=center>
![Static Badge](https://img.shields.io/badge/Language-C%23-purple) ![Static Badge](https://img.shields.io/badge/License-MIT-red) ![Static Badge](https://img.shields.io/badge/IDE-Visual%20Studio-purple) ![Static Badge](https://img.shields.io/badge/Framework-WinUI%203-blue)
</div>
<div align=center>
[![GitHub Repo stars](https://img.shields.io/github/stars/jayfunc/BetterLyrics)](https://github.com/jayfunc/BetterLyrics/stargazers)
</div>
<h4 align="center">
你的动态歌词显示工具,基于 WinUI 3 和 Win2D 构建 —— 支持本地播放及多种播放器
</h3>
## 🎉 本项目被少数派推荐!
查看文章:[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) 文件
- 在线歌词源
- QQ 音乐
- 网易云音乐 NetEase Cloud Music
- 酷狗音乐 Kugou Music
- [amll-ttml-db](https://github.com/Steve-xmh/amll-ttml-db)
- [LRCLIB](https://lrclib.net/)
- 🎶 **支持多种音乐播放器**
- <details><summary>⚠️ 网易云音乐</summary>
- 请先安装 [BetterNCM 插件](https://microblock.cc/betterncm)。如安装后弹出降级指引,请按指引将网易云音乐降级至 2.10.13
- 然后在插件市场安装 InfLink 插件,安装完成后重启网易云音乐即可。
- ⚠️ 由于插件问题,时间轴可能存在异常
</details>
- <details><summary>⚠️ 酷狗音乐</summary>
- 请确保酷狗音乐设置中“支持系统播放控制(如锁屏界面)”已开启
- 酷狗音乐不会广播时间轴信息,导致切换进度时 BetterLyrics 无法检测
- ⚠️ 时间轴问题为酷狗本身限制
</details>
- <details><summary>⚠️ Apple Music</summary>
- 请在设置中将时间轴阈值设为约 600ms“设置”-“高级选项”),否则歌词会不断前后跳动
- ⚠️ 需额外设置以避免歌词抖动(详见文末 FAQ
</details>
- <details><summary>⚠️ foobar2000</summary>
- 请安装 https://github.com/dumbie/foo_mediacontrol
- ⚠️ 由于插件问题,时间轴可能存在异常
</details>
- Spotify
- QQ 音乐
- PotPlayer
- 媒体播放器(系统)
- <details><summary>LX Music</summary>
- 请确保已在 LX Music 设置页开启“Open API”
- 然后在 BetterLyrics 设置-高级选项中填写 LX Music 服务器地址(通常为 http://127.0.0.1:23330即可
</details>
- <details><summary>MusicBee</summary>
- 请安装 https://github.com/HenryPDT/mb_MediaControl
</details>
- <details><summary>iTunes</summary>
- 请安装 https://github.com/thewizrd/iTunes-SMTC
</details>
- <details><summary>AIMP</summary>
- 请安装 https://www.aimp.ru/?do=catalog&rec_id=1097
</details>
- 🪟 **多种显示模式**
- **标准模式**
- 沉浸式歌词动画与动态背景
- **停靠模式**
- 智能歌词条停靠屏幕边缘
- **桌面模式**
- 歌词悬浮于桌面应用之上
- 🧠 **智能行为**
- 音乐暂停时自动隐藏
> 本项目仍在开发中,最新分支可能存在 bug 或异常行为。
## 截图
### 标准模式
![alt text](Screenshots/image.png)
![alt text](Screenshots/glow-float.gif)
![alt text](Screenshots/fan.png)
![alt text](Screenshots/lyrics-only.png)
![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)
## 演示
在 B 站观看我们的介绍视频2025 年 8 月 18 日上传):[点此观看](https://www.bilibili.com/video/BV1yLYtzQEME/)
## 立即体验
### Microsoft Store
<a href="https://apps.microsoft.com/detail/9P1WCD1P597R?referrer=appbadge&mode=direct">
<img src="https://get.microsoft.com/images/en-us%20dark.svg" width="200"/>
</a>
**最简单**的获取方式。**无限制**免费试用或购买(免费与付费无差别)
☕ 如果觉得好用,欢迎在 **Microsoft Store** 购买支持 🧧,感谢!🥰
> 稳定版发布后Microsoft Store 会第一时间更新。
### Google Drive
也可通过 Google Drive 获取(见 [release](https://github.com/jayfunc/BetterLyrics/releases) 页面)
> 下载的是 ".zip" 文件,安装方法请参考 [此文档](How2Install/How2Install.md)。
## 💖 特别感谢
- [Lyricify-Lyrics-Helper](https://github.com/WXRIW/Lyricify-Lyrics-Helper)
- 提供 QQ、网易云、酷狗歌词获取、解密与解析
- [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 App 与 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://api.star-history.com/svg?repos=jayfunc/BetterLyrics&type=Date)](https://www.star-history.com/#jayfunc/BetterLyrics&Date)
## 欢迎提 issue 和 PR
如发现 bug 请在 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`
### 桌面模式如何解锁窗口
![alt text](FAQ/image-7.png)
在系统托盘右键图标,选择“解锁窗口”,或按 `Ctrl + Alt + U`
### 歌词时间轴有延迟
将鼠标悬停在应用底部,
![alt text](FAQ/image.png)
点击第一个图标按钮(歌词时间轴偏移),即可自由调整偏移量。
### 歌词频繁跳动(如 Apple Music
![alt text](FAQ/image-2.png)
进入“高级选项”,增大阈值(红框标记处),直至歌词正常。

View File

@@ -1,275 +0,0 @@
[_點此查看常見問題_](#faq)
![](Promotion/banner.png)
<div align=center>
<img src="BetterLyrics.WinUI3/BetterLyrics.WinUI3/Assets/Logo.png" alt="" width="64">
</div>
<h2 align=center>
BetterLyrics
</h2>
<div align=center>
[![](https://img.shields.io/badge/zh--CN-%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87-blue)](https://github.com/jayfunc/BetterLyrics/blob/dev/README.zh-CN.md) [![Static Badge](https://img.shields.io/badge/zh--TW-%E7%B9%81%E9%AB%94%E4%B8%AD%E6%96%87-blue)](https://github.com/jayfunc/BetterLyrics/blob/dev/README.zh-TW.md) [![Static Badge](https://img.shields.io/badge/ja-%E6%97%A5%E6%9C%AC%E8%AA%9E-blue)](https://github.com/jayfunc/BetterLyrics/blob/dev/README.ja.md) [![Static Badge](https://img.shields.io/badge/ko-%ED%95%9C%EA%B5%AD%EC%9D%B8-blue)](https://github.com/jayfunc/BetterLyrics/blob/dev/README.ko.md)
</div>
<div align=center>
![Static Badge](https://img.shields.io/badge/Language-C%23-purple) ![Static Badge](https://img.shields.io/badge/License-MIT-red) ![Static Badge](https://img.shields.io/badge/IDE-Visual%20Studio-purple) ![Static Badge](https://img.shields.io/badge/Framework-WinUI%203-blue)
</div>
<div align=center>
[![GitHub Repo stars](https://img.shields.io/github/stars/jayfunc/BetterLyrics)](https://github.com/jayfunc/BetterLyrics/stargazers)
</div>
<h4 align="center">
你的動態歌詞顯示工具,基於 WinUI 3 和 Win2D 構建 —— 支援本地播放及多種播放器
</h3>
## 🎉 本專案被少數派推薦!
查看文章:[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) 檔案
- 線上歌詞來源
- QQ 音樂
- 網易雲音樂 NetEase Cloud Music
- 酷狗音樂 Kugou Music
- [amll-ttml-db](https://github.com/Steve-xmh/amll-ttml-db)
- [LRCLIB](https://lrclib.net/)
- 🎶 **支援多種音樂播放器**
- <details><summary>⚠️ 網易雲音樂</summary>
- 請先安裝 [BetterNCM 插件](https://microblock.cc/betterncm)。如安裝後彈出降級指引,請依指引將網易雲音樂降級至 2.10.13
- 然後在插件市集安裝 InfLink 插件,安裝完成後重啟網易雲音樂即可。
- ⚠️ 由於插件問題,時間軸可能存在異常
</details>
- <details><summary>⚠️ 酷狗音樂</summary>
- 請確保酷狗音樂設定中「支援系統播放控制(如鎖屏介面)」已開啟
- 酷狗音樂不會廣播時間軸資訊,導致切換進度時 BetterLyrics 無法偵測
- ⚠️ 時間軸問題為酷狗本身限制
</details>
- <details><summary>⚠️ Apple Music</summary>
- 請在設定中將時間軸閾值設為約 600ms「設定」-「進階選項」),否則歌詞會不斷前後跳動
- ⚠️ 需額外設定以避免歌詞抖動(詳見文末 FAQ
</details>
- <details><summary>⚠️ foobar2000</summary>
- 請安裝 https://github.com/dumbie/foo_mediacontrol
- ⚠️ 由於插件問題,時間軸可能存在異常
</details>
- Spotify
- QQ 音樂
- PotPlayer
- 媒體播放器(系統)
- <details><summary>LX Music</summary>
- 請確保已在 LX Music 設定頁開啟「Open API」
- 然後在 BetterLyrics 設定-進階選項中填寫 LX Music 伺服器位址(通常為 http://127.0.0.1:23330即可
</details>
- <details><summary>MusicBee</summary>
- 請安裝 https://github.com/HenryPDT/mb_MediaControl
</details>
- <details><summary>iTunes</summary>
- 請安裝 https://github.com/thewizrd/iTunes-SMTC
</details>
- <details><summary>AIMP</summary>
- 請安裝 https://www.aimp.ru/?do=catalog&rec_id=1097
</details>
- 🪟 **多種顯示模式**
- **標準模式**
- 沉浸式歌詞動畫與動態背景
- **停靠模式**
- 智慧歌詞條停靠螢幕邊緣
- **桌面模式**
- 歌詞懸浮於桌面應用之上
- 🧠 **智慧行為**
- 音樂暫停時自動隱藏
> 本專案仍在開發中,最新分支可能存在 bug 或異常行為。
## 截圖
### 標準模式
![alt text](Screenshots/image.png)
![alt text](Screenshots/glow-float.gif)
![alt text](Screenshots/fan.png)
![alt text](Screenshots/lyrics-only.png)
![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)
## 演示
在 B 站觀看我們的介紹影片2025 年 8 月 18 日上傳):[點此觀看](https://www.bilibili.com/video/BV1yLYtzQEME/)
## 立即體驗
### Microsoft Store
<a href="https://apps.microsoft.com/detail/9P1WCD1P597R?referrer=appbadge&mode=direct">
<img src="https://get.microsoft.com/images/en-us%20dark.svg" width="200"/>
</a>
**最簡單**的獲取方式。**無限制**免費試用或購買(免費與付費無差別)
☕ 如果覺得好用,歡迎在 **Microsoft Store** 購買支持 🧧,感謝!🥰
> 穩定版發布後Microsoft Store 會第一時間更新。
### Google Drive
也可透過 Google Drive 取得(見 [release](https://github.com/jayfunc/BetterLyrics/releases) 頁面)
> 下載的是 ".zip" 檔案,安裝方法請參考 [此文件](How2Install/How2Install.md)。
## 💖 特別感謝
- [Lyricify-Lyrics-Helper](https://github.com/WXRIW/Lyricify-Lyrics-Helper)
- 提供 QQ、網易雲、酷狗歌詞獲取、解密與解析
- [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 App 與 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://api.star-history.com/svg?repos=jayfunc/BetterLyrics&type=Date)](https://www.star-history.com/#jayfunc/BetterLyrics&Date)
## 歡迎提 issue 和 PR
如發現 bug 請在 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`
### 桌面模式如何解鎖視窗
![alt text](FAQ/image-7.png)
在系統匣右鍵圖示,選擇「解鎖視窗」,或按 `Ctrl + Alt + U`
### 歌詞時間軸有延遲
將滑鼠懸停在應用底部,
![alt text](FAQ/image.png)
點擊第一個圖示按鈕(歌詞時間軸偏移),即可自由調整偏移量。
### 歌詞頻繁跳動(如 Apple Music
![alt text](FAQ/image-2.png)
進入「進階選項」,增大閾值(紅框標記處),直到歌詞正常。