BetterLyrics
🤩 An elegant and deeply customizable lyrics visualizer & versatile music player, built with WinUI3/Win2D
💞 BetterLyrics is made possible by all its contributors, bug reporters and users.
This project is under active development; unexpected issues may occur.
✍️ 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! 😆 See here for more info on how to contribute.
🎉 This project was featured by HelloGitHub!
🎉 This project was featured by SSPAI!
Check out the article: BetterLyrics – An immersive and smooth lyrics display tool designed for Windows.
🔈 Feedback and chat group
QQ 群 (1054700388) | Discord Server | Telegram Group
🌟 Highlighted Features
-
🎨 Stunning Visuals & UI
- Elegant Design: Smooth, highly personalized style powered by WinUI3 & Win2D.
- Immersive Effects: Fluid backgrounds, 3D/Fan-shaped lyrics, snowflake particles, and more.
- Deep Customization: Configure animations, fonts, and behaviors to your taste.
-
🎧 Versatile Playback & Connectivity
- Built-in Player:
- Play from Local Drives.
- Stream via Network Protocols (SMB, WebDAV).
- Supports embedded lyrics reading.
- External Integration:
- Visualizes music from Spotify, Apple Music, NetEase, and many others.
- Built-in Player:
-
🌐 Advanced Lyrics System
- Offline Translation: Privacy-focused local machine translation (30+ languages).
- Comprehensive Sources:
- 💾 Files: .lrc (Standard/Enhanced), .eslrc, .ttml, and embedded tags.
- ☁️ Online: QQ Music, NetEase, KuGou, LRCLIB, amll-ttml-db.
- 🍎 Apple Music: (Requires token configuration).
-
🪟 Display Modes for Every Scenario
- Standard: Full immersive experience.
- Docked: A sleek bar attached to your screen edge.
- Desktop Overlay: Lyrics floating above all apps.
- ...and more to discover.
-
🧠 Smart Behaviors
- Auto-hides when music pauses.
🖼️ Screenshots
⚠️ 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.
📹 Demonstration
Watch our demo video (uploaded on 21 Oct 2025) on Bilibili here.
🧪 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 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
- Go to latest release and download
.zipfile fromAssets. (See this doc for how to install it.)
🏗️ Build
Before you build, make sure that you have already:
- Replaced
BetterLyrics\BetterLyrics.WinUI3\BetterLyrics.WinUI3\Constants\DiscordTemplatewithBetterLyrics\BetterLyrics.WinUI3\BetterLyrics.WinUI3\Constants\DiscordTemplate.cs. - Replaced
BetterLyrics\BetterLyrics.WinUI3\BetterLyrics.WinUI3\Constants\LastFMTemplatewithBetterLyrics\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:
-
支付宝
-
微信
This project is made possible by the generous support of our users. View the full Hall of Fame
📄 License
This project is licensed under the GNU General Public License v3.0. See the 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 | Provide lyrics fetch, decryption, and parsing for QQ, Netease, and Kugou sources |
| lrclib | LRCLIB lyrics API provider |
| Manzana-Apple-Music-Lyrics | Apple Music lyrics fetch using Python |
| Audio Tools Library (ATL) for .NET | Used for extracting pictures from music files |
| WinUIEx | Provide easy ways to access the Win32 API regarding windowing |
| TagLib# | Used for reading the original lyrics content |
| Vanara | Win32 API wrapper |
| LibreTranslate | Provide the ability for offline lyrics translation |
| Isolation | Dynamic fluid background implementation |
| SpectrumVisualization | Audio visualization reference |
| DevWinUI | Provide many out-of-the-box features for building WinUI 3 applications |
| ... | ... |
See all the dependencies here.
Tutorials/Blogs/etc.
- Stackoverflow - How to animate Margin property in WPF
- Bilibili -【WinUI3】SystemBackdropController：定义云母、亚克力效果
- cnblogs - .NET App 与 Windows 系统媒体控制(SMTC)交互
- Win2D 中的游戏循环：CanvasAnimatedControl
- r2d2rigo/Win2D-Samples
- CommunityToolkit - 从入门到精通
💡 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).
⭐ 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.