Welcome to BetterLyrics

An elegant and deeply customizable lyrics visualizer & versatile music player, built with WinUI3/Win2D.

This welcome page is designed to help users quickly identify and resolve common issues:

BetterLyrics relies entirely on the Windows System Media Transport Controls (SMTC) protocol to function.

Quick Troubleshooting

If BetterLyrics is not displaying lyrics after launch, or if the text/progress is incorrect, please follow these self-check steps:

Step One: Check the Playback Source

Is your music player reporting its status to Windows SMTC?

• Desktop Clients (QQ Music, NetEase Cloud Music, etc.):
  • Many players require additional configuration. Please ensure you have installed the corresponding plugins or adjusted the player settings according to the instructions.

Step Two: Check Software Settings

Is BetterLyrics ignoring the application?

• Go to BetterLyrics Settings -> Playback Source.
• Check if your player's name is in the source list and ensure the option to "Listen to new playback sources" is enabled.

---

Getting Started Recommendations

For an "out-of-the-box" seamless experience, we recommend the following environments:

Platform	Recommended Client	Description
Streaming	QQ Music	The official client has the best SMTC support; works with plugins for precise matching.
Streaming	Apple Music	The official client provides excellent SMTC support with no extra configuration needed.
Local Music	BetterLyrics Built-in Player	Supports numerous formats with direct playback—fast and easy.