elmgates/BetterLyrics
1
0
Fork 0
mirror of https://github.com/jayfunc/BetterLyrics.git synced 2026-01-13 03:34:55 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
0593f9aa3fc30bb1de4465efea40eb2ee315db67
BetterLyrics/README.md
Zhe Fang eb05c1ea13 update readme
2025-08-04 10:01:37 -04:00

11 KiB
Raw Blame History

Click here to view frequently asked questions (FAQ)

BetterLyrics

Static Badge Static Badge Static Badge

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

🌟 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 Music
      • 网易云音乐 NetEase Cloud Music
      • 酷狗音乐 Kugou Music
      • amll-ttml-db
      • LRCLIB

  • 🎶 Multiple Music Players Supported

    • ⚠️ NetEase Cloud Music
      • Please install the BetterNCM plugin first. If a downgrade guide pops up after the installation, please follow the guide to complete the downgrade of NetEase Cloud Music (downgrade to 2.10.13);
      • After that, please install the InfLink plugin in PluginMarket. After the installation is complete, please restart NetEase Cloud Music. At this point, all preparatory operations have been completed, enjoy it!
      • ⚠️ Please note that there is issues with timeline due to plugin issue
    • ⚠️ Kugou Music
      • Please make sure that the Kugou Music setting "Support system playback controls, such as lock screen interface" is turned on
      • No timeline information broadcasted, which means when you change timeline position in Kugou Music, BetterLyrics has no way to detect this change.
      • ⚠️ Please note that there is issues with timeline due to Kugou itself
    • ⚠️ Apple Music
      • Make sure you have set timeline threshold to around 600 ms in settings (Go to "Settings" - "Advanced option" to change), otherwise, the lyrics will be moving forward and afterward constantly.
      • ⚠️ Please note that you need additional settings to stop from seeing shaking lyrics (see FAQ at the end of this document for more information)
    • ⚠️ foobar2000

    • Spotify

    • QQ Music

    • PotPlayer

    • Media Player (System)

    • LX Music
      • Please make sure you have enabled "Open API" in LX Music settings page
      • Then open BetterLyrics, go to settings, go to "Advanced options", 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 behaviors may be existed in the latest branch.

Screenshots

Standard mode

alt text

alt text

alt text

alt text

alt text

Dock mode

alt text

alt text

Desktop mode

alt text

alt text

Demonstration

Watch our introduction video (uploaded on 7 July 2025) on Bilibili here.

Try it now

Microsoft Store

Easiest way to get it. Unlimited free trail or purchase (there is no difference between free and paid version)

☕ If you find it useful, please consider purchasing 🧧 it in Microsoft Store, I'll appreciate it! 🥰

When there's a stable version built, Microsoft Store will be the first channel to get updated.

Google Drive

Or get it from Google Drive (see release page for the link)

Please note you are downloading ".zip" file, for guide on how to install it, please kindly follow this doc.

💖 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! 😆 Click the link to translate this app into your language via Crowdin now!

Star history

Any issues and PRs are welcomed

If you find a bug please file it in issues or if you have any ideas feel free to share it here.

FAQ

I couldn't see any button in dock mode

It is important to note that when you enter "Docked Mode", the action buttons are hidden. Hover your mouse over the top to access the "Immerse", "More", and "Close" buttons.

alt text

Hover the mouse slightly above the bottom edge of the window to display the white control floating window at the bottom

alt text

Tap the "little white bar" to display the bottom control bar in floating window form (including current playback progress view, timeline offset adjustment; previous song, pause/play, next song; translation, layout, settings)

alt text

How can I lock the window in desktop mode

alt text

Hover you mouse on the top, click on the lock icon and you're good to go! Or, alternatively, press Ctrl + Alt + U.

How can I unlock the window in desktop mode

alt text

It's in the system tray, right-click on the icon and you'll see "Unlock the window". Or, alternatively, press Ctrl + Alt + U.

There's a delay in lyrics timeline

Hover you mouse on the very bottom of the app,

alt text

And then click on the first icon button (Lyrics timeline offset), here you can adjust the offset freely.

The lyrics jump back and forth frequently (e.g. Apple Music)

alt text

Go to "Advanced options" section, increase the threshold value (marked with the bigger red rectangle) until the lyrics is working properly.