mirror of
https://github.com/jayfunc/BetterLyrics.git
synced 2026-01-12 19:24:55 +08:00
269 lines
11 KiB
Markdown
269 lines
11 KiB
Markdown
[_Click here to view frequently asked questions (FAQ)_](https://github.com/jayfunc/BetterLyrics/blob/dev/FAQ/FAQ.md)
|
||
|
||
|
||
|
||
<div align=center>
|
||
<img src="BetterLyrics.WinUI3/BetterLyrics.WinUI3/Assets/Logo.png" alt="" width="64">
|
||
</div>
|
||
|
||
<h2 align=center>
|
||
BetterLyrics
|
||
</h2>
|
||
|
||
<div align=center>
|
||
|
||
   
|
||
|
||
</div>
|
||
|
||
<div align=center>
|
||
|
||
[](https://github.com/jayfunc/BetterLyrics/stargazers)
|
||
|
||
</div>
|
||
|
||
<h4 align="center">
|
||
Your dynamic lyrics display tool, built with WinUI 3 and Win2D, works with local playback and other players
|
||
</h3>
|
||
|
||
## 🎉 This project was featured by SSPAI!
|
||
|
||
Check out the article: [BetterLyrics – An immersive and smooth lyrics display tool designed for Windows](https://sspai.com/post/101028)
|
||
|
||
## 🔈 Feedback and chat group
|
||
|
||
[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 Server](https://discord.gg/5yAQPnyCKv) | [Telegram Group](https://t.me/+svhSLZ7awPsxNGY1)
|
||
|
||
## 🌟 Highlighted features
|
||
|
||
- 🌠 **Pleasing User Interface**
|
||
- Fluent animations and effects
|
||
- ↔️ **Strong Lyrics Translation**
|
||
- Offline machine translation (supporting 30+ languages)
|
||
- Auto-reading local lyrics files for embedded translation
|
||
- 🧩 **Various Lyrics Source**
|
||
- 💾 Local storage
|
||
- Music files (with embedded lyrics)
|
||
- [.lrc](<https://en.wikipedia.org/wiki/LRC_(file_format)>) files (with both core format and enhanced format)
|
||
- [.eslrc](https://github.com/ESLyric/release) files
|
||
- [.ttml](https://en.wikipedia.org/wiki/Timed_Text_Markup_Language) files
|
||
- ☁️ Online lyrics providers
|
||
- QQ 音乐
|
||
- 网易云音乐
|
||
- 酷狗音乐
|
||
- [amll-ttml-db](https://github.com/Steve-xmh/amll-ttml-db)
|
||
- [LRCLIB](https://lrclib.net/)
|
||
- <details><summary>⚠️ Apple Music (additional config needed)</summary>
|
||
|
||
- Open the Apple Music web app and the Developer Tools window. Refresh the page. Return to the Developer Tools window, select Fetch/XHR, select a request, find the Media-User-Token header in the request header, and copy its value.
|
||
- Open BetterLyrics and go to the Playback Source settings. Enter the copied value in the Media-User-Token (for Apple Music) setting and click the accept icon on the right-hand side.
|
||
|
||
- 🎶 **Multiple Music Players Supported**
|
||
|
||
- <details><summary>网易云音乐</summary>
|
||
|
||
- Please make sure that you have the latest version (3.1.20+) of 网易云音乐 installed on your PC.
|
||
- Install the [BetterNCM plugin](https://microblock.cc/betterncm) first
|
||
- After that, install the [InfLink-rs](https://github.com/apoint123/inflink-rs) plugin in PluginMarket. After the installation is complete, please restart 网易云音乐. At this point, all preparatory operations have been completed. Enjoy it!
|
||
|
||
</details>
|
||
|
||
- <details><summary>⚠️ 酷狗音乐</summary>
|
||
|
||
- Please make sure that the 酷狗音乐 setting "Support system playback controls, such as lock screen interface" is turned on
|
||
- No timeline information broadcast, which means when you change the timeline position in Kugou Music, BetterLyrics has no way to detect this change
|
||
- ⚠️ Please note that there are issues with the timeline due to Kugou itself
|
||
|
||
</details>
|
||
|
||
- <details><summary>⚠️ foobar2000</summary>
|
||
|
||
- Make sure you have https://github.com/dumbie/foo_mediacontrol installed with it
|
||
- ⚠️ Please note that there are issues with the timeline due to a plugin issue
|
||
|
||
</details>
|
||
|
||
- Apple Music
|
||
- Spotify
|
||
- PotPlayer
|
||
- Media Player (System)
|
||
|
||
- <details><summary>QQ 音乐</summary>
|
||
|
||
- Please keep it at the latest version
|
||
- Then open Settings in QQ 音乐, enable "Show System Media Transport Controls (SMTC)".
|
||
|
||
</details>
|
||
|
||
- <details><summary>LX Music</summary>
|
||
|
||
- Please make sure you have enabled "Open API" in LX Music settings page
|
||
- Then open BetterLyrics, go to settings, go to "Playback sources", input your LX Music server address (mostly like http://127.0.0.1:23330) and there you go!
|
||
|
||
</details>
|
||
|
||
- <details><summary>MusicBee</summary>
|
||
|
||
- Please install https://github.com/HenryPDT/mb_MediaControl before using
|
||
|
||
</details>
|
||
|
||
- <details><summary>iTunes</summary>
|
||
|
||
- Please install https://github.com/thewizrd/iTunes-SMTC before using
|
||
|
||
</details>
|
||
|
||
- <details><summary>AIMP</summary>
|
||
|
||
- Please install https://www.aimp.ru/?do=catalog&rec_id=1097 before using
|
||
|
||
</details>
|
||
|
||
- 🪟 **Multiple Display Modes**
|
||
- **Standard Mode**
|
||
- Enjoy an immersive listening journey with rich lyrics, animations and beautifully dynamic backgrounds
|
||
- **Dock Mode**
|
||
- A smart animated lyrics bar docked to your screen edge
|
||
- **Desktop Mode**
|
||
- Enjoy immersive lyrics floating above your apps
|
||
- 🧠 **Smart Behaviors**
|
||
- Auto hide when music paused
|
||
|
||
> This project is still under development, bugs and unexpected behaviours may exist in the latest branch.
|
||
|
||
## Screenshots
|
||
|
||
### Standard mode
|
||
|
||
|
||
|
||
### Narrow mode
|
||
|
||
|
||
|
||
### Fullscreen mode
|
||
|
||
|
||
|
||
### Docked mode
|
||
|
||
|
||
|
||
### Desktop mode
|
||
|
||
|
||
|
||
## Demonstration
|
||
|
||
Watch our demo video (uploaded on 21 Oct 2025) on Bilibili [here](https://www.bilibili.com/video/BV1QRstz1EGt/).
|
||
|
||
## Try it now
|
||
|
||
### Microsoft Store (Latest version)
|
||
|
||
<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>
|
||
|
||
**Unlimited** free trail or purchase (there is **no difference** between free and paid version)
|
||
|
||
☕ If you find it useful, please consider [donating](#donations) or purchasing 🧧 it in **Microsoft Store**, I'll appreciate it! 🥰
|
||
|
||
### Unable to download from the MS Store? (Alternative way to download from MS Store, latest version too)
|
||
|
||
1. Visit https://store.rg-adguard.net/
|
||
2. Type https://apps.microsoft.com/detail/9p1wcd1p597r in the link input area
|
||
3. Select Retail from the drop-down list
|
||
4. Click the check mark
|
||
5. Select the largest installation package in the resulting list to download and install. If you fail to install, try to install the dependency packages first.
|
||
|
||
### Unable to launch the app?
|
||
|
||
If you are using a third-party modified Windows, you probably can not launch the app.
|
||
|
||
To solve this issue, please try to download from [Google Drive (v1.0.82.0)](https://drive.google.com/file/d/1UtGmmDqD5SWGJpp4LmWycHUT9-Bb8fur/view?usp=sharing) (may not be the latest version) and follow the instructions [here](https://github.com/jayfunc/BetterLyrics/blob/dev/How2Install/How2Install.md).
|
||
|
||
## Build
|
||
|
||
Before you build, make sure that you have already replaced `BetterLyrics\BetterLyrics.WinUI3\BetterLyrics.WinUI3\Constants\LastFMTemplate` with `BetterLyrics\BetterLyrics.WinUI3\BetterLyrics.WinUI3\Constants\LastFM.cs`
|
||
|
||
## 💖 Many thanks to
|
||
|
||
- [Lyricify-Lyrics-Helper](https://github.com/WXRIW/Lyricify-Lyrics-Helper)
|
||
- Provide lyrics fetch, decryption, and parsing for QQ, Netease, and Kugou sources
|
||
- [lrclib](https://github.com/tranxuanthang/lrclib)
|
||
- LRCLIB lyrics API provider
|
||
- [Manzana-Apple-Music-Lyrics](https://github.com/dropcreations/Manzana-Apple-Music-Lyrics)
|
||
- Apple Music lyrics fetch using Python
|
||
- [Audio Tools Library (ATL) for .NET](https://github.com/Zeugma440/atldotnet)
|
||
- Used for extracting pictures from music files
|
||
- [WinUIEx](https://github.com/dotMorten/WinUIEx)
|
||
- Provide easy ways to access the Win32 API regarding windowing
|
||
- [TagLib#](https://github.com/mono/taglib-sharp)
|
||
- Used for reading the original lyrics content
|
||
- [Vanara](https://github.com/dahall/Vanara)
|
||
- Win32 API wrapper
|
||
- [LibreTranslate](https://github.com/LibreTranslate/LibreTranslate)
|
||
- Provide the ability for offline lyrics translation
|
||
- [Isolation](https://github.com/Storyteller-Studios/Isolation)
|
||
- Dynamic fluid background implementation
|
||
- [Stackoverflow - How to animate Margin property in WPF](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/)
|
||
|
||
## Inspired by
|
||
|
||
- [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)
|
||
|
||
## ✍️ Help us translate into your language
|
||
|
||
Cannot find your language?
|
||
Don't worry! Start translating and become one of the contributors! 😆
|
||
|
||
Fork this project and navigate to `BetterLyrics\BetterLyrics.WinUI3\BetterLyrics.WinUI3\Strings\` then open any `.resw` file to start contributing!
|
||
|
||
## Star history
|
||
|
||
[](https://www.star-history.com/#jayfunc/BetterLyrics&Date)
|
||
|
||
## Any issues and PRs are welcome
|
||
|
||
If you find a bug, please file it in issues, or if you have any ideas, feel free to share them here.
|
||
|
||
## Donations
|
||
|
||
If you like this project, please consider supporting it by donating. Your support will help keep the project alive and encourage further development.
|
||
|
||
You can donate via:
|
||
- [PayPal](https://paypal.me/zhefangpay)
|
||
- [Buy Me a Coffee](https://buymeacoffee.com/founchoo)
|
||
- <details><summary>支付宝</summary>
|
||
|
||
|
||
|
||
</detais>
|
||
|
||
- <details><summary>微信</summary>
|
||
|
||
|
||
|
||
</details>
|
||
|
||
## ⚠️ Disclaimer
|
||
|
||
This project is provided "as is" without warranty of any kind.
|
||
|
||
All lyrics, fonts, icons, and other third-party resources are the property of their respective copyright holders.
|
||
The author of this project does not claim ownership of such resources.
|
||
|
||
This project is non-commercial and should not be used to infringe any rights.
|
||
Users are responsible for ensuring their own use complies with applicable laws and licenses.
|