![](Promotion/banner.png)

BetterLyrics

🤩 An elegant and deeply customizable lyrics & player app, built with WinUI3/Win2D

[User Guide](https://github.com/jayfunc/BetterLyrics/wiki/User-Guide) | [Privacy Policy](PrivacyPolicy.md) | [Terms of Service](TermsofService.md)
![Static Badge](https://img.shields.io/badge/Language-C%23-purple) ![Static Badge](https://img.shields.io/badge/License-GPL_v3.0-blue) ![Static Badge](https://img.shields.io/badge/IDE-Visual%20Studio-purple) ![Static Badge](https://img.shields.io/badge/Framework-WinUI%203-blue)
[![GitHub Repo stars](https://img.shields.io/github/stars/jayfunc/BetterLyrics)](https://github.com/jayfunc/BetterLyrics/stargazers) [![Crowdin](https://badges.crowdin.net/betterlyrics/localized.svg)](https://crowdin.com/project/betterlyrics)
[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/jayfunc/BetterLyrics) [![zread](https://img.shields.io/badge/Ask_Zread-_.svg?style=flat&color=00b0aa&labelColor=000000&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTQuOTYxNTYgMS42MDAxSDIuMjQxNTZDMS44ODgxIDEuNjAwMSAxLjYwMTU2IDEuODg2NjQgMS42MDE1NiAyLjI0MDFWNC45NjAxQzEuNjAxNTYgNS4zMTM1NiAxLjg4ODEgNS42MDAxIDIuMjQxNTYgNS42MDAxSDQuOTYxNTZDNS4zMTUwMiA1LjYwMDEgNS42MDE1NiA1LjMxMzU2IDUuNjAxNTYgNC45NjAxVjIuMjQwMUM1LjYwMTU2IDEuODg2NjQgNS4zMTUwMiAxLjYwMDEgNC45NjE1NiAxLjYwMDFaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00Ljk2MTU2IDEwLjM5OTlIMi4yNDE1NkMxLjg4ODEgMTAuMzk5OSAxLjYwMTU2IDEwLjY4NjQgMS42MDE1NiAxMS4wMzk5VjEzLjc1OTlDMS42MDE1NiAxNC4xMTM0IDEuODg4MSAxNC4zOTk5IDIuMjQxNTYgMTQuMzk5OUg0Ljk2MTU2QzUuMzE1MDIgMTQuMzk5OSA1LjYwMTU2IDE0LjExMzQgNS42MDE1NiAxMy43NTk5VjExLjAzOTlDNS42MDE1NiAxMC42ODY0IDUuMzE1MDIgMTAuMzk5OSA0Ljk2MTU2IDEwLjM5OTlaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik0xMy43NTg0IDEuNjAwMUgxMS4wMzg0QzEwLjY4NSAxLjYwMDEgMTAuMzk4NCAxLjg4NjY0IDEwLjM5ODQgMi4yNDAxVjQuOTYwMUMxMC4zOTg0IDUuMzEzNTYgMTAuNjg1IDUuNjAwMSAxMS4wMzg0IDUuNjAwMUgxMy43NTg0QzE0LjExMTkgNS42MDAxIDE0LjM5ODQgNS4zMTM1NiAxNC4zOTg0IDQuOTYwMVYyLjI0MDFDMTQuMzk4NCAxLjg4NjY0IDE0LjExMTkgMS42MDAxIDEzLjc1ODQgMS42MDAxWiIgZmlsbD0iI2ZmZiIvPgo8cGF0aCBkPSJNNCAxMkwxMiA0TDQgMTJaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00IDEyTDEyIDQiIHN0cm9rZT0iI2ZmZiIgc3Ryb2tlLXdpZHRoPSIxLjUiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIvPgo8L3N2Zz4K&logoColor=ffffff)](https://zread.ai/jayfunc/BetterLyrics)
**_💞 BetterLyrics is made possible by all its contributors, bug reporters and users._**
**_[中文版 README 请点按此处](https://github.com/jayfunc/BetterLyrics/blob/dev/README.CN.md)_** **_This project is under active development; unexpected issues may occur._**
## 🎉 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** - Smooth and highly personalized style, animations and effects - Immersive fluid background - Perspective/fan-shaped lyrics - Snowflake effect - Multiple lyrics scrolling functions - ... (and more) - ↔️ **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** - Check it out [here](https://github.com/jayfunc/BetterLyrics/wiki/User-Guide#known-supported-music-players-configuration-guide) for detailed info - 🪟 **Multiple Display Modes** - **Standard Mode** - Enjoy an immersive listening journey with rich lyrics, animations and beautifully dynamic backgrounds - **Docked Mode** - A smart animated lyrics bar docked to your screen edge - **Desktop Mode** - Enjoy immersive lyrics floating above your apps - **And More...** - Waiting for you to discover... - 🧠 **Smart Behaviors** - Auto hide when music paused ## 🖼️ Screenshots ![](Screenshots/fs2.png) ![](Screenshots/std.png) ![](Screenshots/narrow.png) ![](Screenshots/Snipaste_2025-10-31_19-23-17.png) ![](Screenshots/Snipaste_2025-10-31_19-27-34.png) ![](Screenshots/dock.png) ![](Screenshots/desktop.png) > ⚠️ Due to GIF format and frame rate limitations, the displayed effect is for preview only. Please refer to the actual device for the actual effect. ![](Screenshots/PixPin_2025-10-24_18-13-44.gif) ![](Screenshots/PixPin_2025-10-24_18-17-17.gif) ## 📹 Demonstration Watch our demo video (uploaded on 21 Oct 2025) on Bilibili [here](https://www.bilibili.com/video/BV1QRstz1EGt/). ## 🧪 Try it now **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! 🥰 Having trouble downloading and installing from the MS Store? Try the following options: - [Download from outside Microsoft Store](https://jayfunc.blog/blog/download-from-outside-ms-store) - Go to [latest release](https://github.com/jayfunc/BetterLyrics/releases/latest) and download `.zip` file from `Assets`. (See [this doc](https://jayfunc.blog/blog/how-to-install-zip) for how to install it.) ## 🏗️ Build Before you build, make sure that you have already: - Replaced `BetterLyrics\BetterLyrics.WinUI3\BetterLyrics.WinUI3\Constants\DiscordTemplate` with `BetterLyrics\BetterLyrics.WinUI3\BetterLyrics.WinUI3\Constants\DiscordTemplate.cs`. - Replaced `BetterLyrics\BetterLyrics.WinUI3\BetterLyrics.WinUI3\Constants\LastFMTemplate` with `BetterLyrics\BetterLyrics.WinUI3\BetterLyrics.WinUI3\Constants\LastFM.cs`. ## 🤑 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) - [爱发电](https://afdian.com/a/jayfunc) -
支付宝 ![](Donate/Alipay.jpg) -
微信 ![](Donate/WeChatReward.png)
This project is made possible by the generous support of our users. **[View the full Hall of Fame](SPONSORS.md)** ## 📄 License This project is licensed under the GNU General Public License v3.0. See the [LICENSE](https://github.com/jayfunc/BetterLyrics/blob/dev/LICENSE) file for details. ## 💖 Many thanks to Some functions and code are referenced or modified from public repositories, including but not limited to the following open source projects/packages, tutorials, etc., and we would like to express our gratitude to them here. | Projects/Packages | Description | | :--- | :--- | | [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 | | [SpectrumVisualization](https://github.com/Johnwikix/SpectrumVisualization) | Audio visualization reference | | [DevWinUI](https://github.com/ghost1372/DevWinUI) | Provide many out-of-the-box features for building WinUI 3 applications | | ... | ... | See all the dependencies [here](https://github.com/jayfunc/BetterLyrics/network/dependencies). ### Tutorials/Blogs/etc. - [Stackoverflow - How to animate Margin property in WPF](https://stackoverflow.com/a/21542882/11048731) - [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 Some design ideas are referenced from the following plugins/software (excluding code that is indirectly or directly referenced or modified, and is only used as a guide for design ideas). - [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 [BetterLyrics](https://crowdin.com/project/betterlyrics/invite?h=413bb0df7afa420247a98fefdae5e12c2647410) on crowdin to accept the invitation and become a valuable translator now! | Language | Code | Translated | Proofread | Contributors | | :--- | :---: | :---: | :---: | :--- | | Arabic | ar | ✅ | - | - | | German | de | ✅ | - | - | | English | en | ✅ | ✅ | [jayfunc](https://crowdin.com/profile/jayfunc) | | Spanish | es | ✅ | - | - | | French | fr | ✅ | - | - | | Hindi | hi | ✅ | - | - | | Indonesian | id | ✅ | - | - | | Japanese | ja | ✅ | - | - | | Korean | ko | ✅ | - | - | | Malay | ms | ✅ | - | - | | Portuguese | pt | ✅ | - | - | | Russian | ru | ✅ | - | - | | Thai | th | ✅ | - | - | | Vietnamese | vi | ✅ | - | - | | Simplified Chinese | zh-Hans | ✅ | ✅ | [jayfunc](https://crowdin.com/profile/jayfunc)
[borcolasky](https://crowdin.com/profile/borcolasky) | | Traditional Chinese | zh-Hant | ✅ | ✅ | [borcolasky](https://crowdin.com/profile/borcolasky) | ## ⭐ Star history
## 🤗 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. ## ⚠️ 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. ## 💭 Share it on social media ![BetterLyrics](https://socialify.git.ci/jayfunc/BetterLyrics/image?description=1&forks=1&issues=1&language=1&name=1&owner=1&pulls=1&stargazers=1&theme=Light) ![BetterLyrics](https://opengraph.githubassets.com//jayfunc/BetterLyrics)