[_Click here to view frequently asked questions (FAQ)_](https://github.com/jayfunc/BetterLyrics/blob/dev/FAQ/FAQ.md)

![](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>

![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">
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

![alt text](Screenshots/std.png)

### Narrow mode

![alt text](Screenshots/std-narrow.png)

### Fullscreen mode

![alt text](Screenshots/std-fullscreen.png)

### Docked mode

![alt text](Screenshots/dock.png)

### Desktop mode

![alt text](Screenshots/desktop.png)

## Demonstration

Watch our introduction video (uploaded on 18 Aug 2025) on Bilibili [here](https://www.bilibili.com/video/BV1yLYtzQEME/).

## 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.79.0)](https://drive.google.com/file/d/1YT8Cg5unPoNJO0FBR9s4w7T2pCLIZQz9/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://api.star-history.com/svg?repos=jayfunc/BetterLyrics&type=Date)](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>
    
  ![](Donate/Alipay.jpg)
  
  </detais>

- <details><summary>微信</summary>
    
  ![](Donate/WeChatReward.png)
  
  </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.
