[_Click here to view frequently asked questions (FAQ)_](https://github.com/jayfunc/BetterLyrics/blob/dev/FAQ/index.md)
BetterLyrics
   
[](https://github.com/jayfunc/BetterLyrics/stargazers)
Your dynamic lyrics display tool, built with WinUI 3 and Win2D, works with local playback and other players
## 🎉 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]() 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/)
- ⚠️ Apple Music (additional config needed)
- 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**
- 网易云音乐
- 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!
⚠️ 酷狗音乐
- 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
⚠️ foobar2000
- 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
QQ 音乐
- Please keep it at the latest version
- Then open Settings in QQ 音乐, enable "Show System Media Transport Controls (SMTC)".
LX Music
- 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!
MusicBee
- Please install https://github.com/HenryPDT/mb_MediaControl before using
iTunes
- Please install https://github.com/thewizrd/iTunes-SMTC before using
AIMP
- Please install https://www.aimp.ru/?do=catalog&rec_id=1097 before using
**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 (see [release](https://github.com/jayfunc/BetterLyrics/releases/latest) for the download link) and follow the instructions [here](https://github.com/jayfunc/BetterLyrics/blob/dev/Sideloadly/index.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? Or have better translations? Don't worry! Start translating and becoming one of the contributors! 😆
Visit https://crowdin.com/project/betterlyrics/invite?h=c9bfb28fce061484883c0891e7a26f9b2592556 to accept invitation and become a valuable translator now!
## 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)
- 支付宝
- 微信
