Skip to content

Your dynamic lyrics display tool built with WinUI 3 and Win2D - works with local playback and other music players | 使用 WinUI 3 和 Win2D 打造的动态歌词显示工具 - 支持本地播放及其他音乐播放器

License

Notifications You must be signed in to change notification settings

jayfunc/BetterLyrics

Repository files navigation

Click here to view frequently asked questions (FAQ)

BetterLyrics

Static Badge Static Badge Static Badge Static Badge

GitHub Repo stars

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

🔈 Feedback and chat group

QQ 群 (1054700388) | Discord Server | Telegram Group

🌟 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 files
      • .ttml files
    • ☁️ Online lyrics providers
      • QQ 音乐

      • 网易云音乐

      • 酷狗音乐

      • amll-ttml-db

      • LRCLIB

      • ⚠️ 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 be sure that your Netease Cloud Music is at version 3.1.4 x64 | x86
      • Install the BetterNCM plugin first
      • After that, install the InfLink plugin in PluginMarket. After the installation is complete, please restart 网易云音乐. At this point, all preparatory operations have been completed. Enjoy it!
      • ⚠️ Please note that there are issues with the timeline due to a plugin issue
    • ⚠️ 酷狗音乐
      • Please make sure that the Kugou Music 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
    • Apple Music

    • Spotify

    • PotPlayer

    • Media Player (System)

    • 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
    • iTunes
    • AIMP
  • 🪟 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

Standard mode (narrow)

alt text

Standard mode (fullscreen)

alt text

Dock mode

alt text

Desktop mode

alt text

Demonstration

Watch our introduction video (uploaded on 18 Aug 2025) on Bilibili here.

Try it now

Microsoft Store (Latest version)

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! 🥰

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.73.0) (may not be the latest version) and follow the instructions here.

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

Inspired by

✍️ 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

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:

⚠️ 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.

About

Your dynamic lyrics display tool built with WinUI 3 and Win2D - works with local playback and other music players | 使用 WinUI 3 和 Win2D 打造的动态歌词显示工具 - 支持本地播放及其他音乐播放器

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 3

  •  
  •  
  •  

Languages