BetterLyrics

English | 中文

<div align="center"> <img src="BetterLyrics.WinUI3/Assets/Logo.png" alt="Logo" width="120"> <h1>BetterLyrics</h1> <h3>Strums the Heartstrings, Graces the Wordscapes</h4> <h4> An elegant and deeply customizable lyrics visualizer & versatile music player<br>Built with WinUI3 / Win2D </h4> <div> <img src="https://img.shields.io/badge/Language-C%23-purple" alt="C#"> <img src="https://img.shields.io/badge/Framework-WinUI%203-blue" alt="WinUI 3"> <img src="https://img.shields.io/badge/License-GPL_v3.0-blue" alt="License"> <a href="https://github.com/jayfunc/BetterLyrics/stargazers"><img src="https://img.shields.io/github/stars/jayfunc/BetterLyrics" alt="Stars"></a> <a href="https://crowdin.com/project/betterlyrics"><img src="https://badges.crowdin.net/betterlyrics/localized.svg" alt="Crowdin"></a> <a href="https://betterlyrics.github.io"><img alt="GitHub Actions Workflow Status" src="https://img.shields.io/github/actions/workflow/status/BetterLyrics/BetterLyrics.github.io/pages%2Fpages-build-deployment?label=Official%20Website"></a> <a href="https://github.com/jayfunc/BetterLyrics/releases/latest"><img src="https://img.shields.io/github/downloads/jayfunc/BetterLyrics/total?label=Downloads"></a> </div> <br> <img src="docs/assets/promotion/banner.png" alt="Banner" width="100%" style="border-radius: 10px;"> </div> <br>

🔥 Featured & Community

<div align="center">

| Featured by HelloGitHub | Featured by SSPAI | 🤖 Ask AI | | :---: | :---: | :---: | | <a href="https://hellogithub.com/repository/jayfunc/BetterLyrics" target="_blank"><img src="https://abroad.hellogithub.com/v1/widgets/recommend.svg?rid=d2af74f0aea146ad8e4b2086982f5777&claim_uid=SgtQs9c54C8wjnv" alt="HelloGitHub" height="40"></a> | Read the Review Article | <br> |

Chat Groups: QQ Group 1 (1054700388) | QQ Group 2 (1076554669) | QQ Channel (BetterLyrics4U) | Discord | Telegram

</div>

🧪 Download & Install

<div align="center">

| Microsoft Store (Recommended) | Manual Install | | :---: | :---: | | <a href="https://apps.microsoft.com/detail/9P1WCD1P597R?referrer=appbadge&mode=direct"><img src="https://get.microsoft.com/images/en-us%20dark.svg" width="160"/></a><br>Unlimited free trial (Same as paid) | 📦 Latest Release (.zip)<br>See Installation Guide |

📖 Docs | 🔒 Privacy Policy | ⚖️ Terms of Service

</div>

🌟 Highlighted Features

• 🎨 Stunning Visuals & Expressive Lyrics

  • Buttery-Smooth UI: A modern experience powered by WinUI 3 & Win2D, featuring fluid animations and extensive personalization.
  • Advanced Lyric Motion: Every word breathes with the music. Includes per-syllable highlighting, long-note duration glows, and perspective-based fading for distant lines.
  • Total Visual Control: Beyond presets, you have full control to fine-tune lyric animations, fonts, and individual visual behaviors to match your unique taste.
  • Immersive Backgrounds: Beautiful visual effects including Dynamic Fluid, Blur, Fog, and Snowflake particles.
  • Audio Visualizer: Built-in real-time spectrum analyzer that brings your music to life.
  • Lyrics Cards: Generate and share gorgeous lyric cards with 10+ artistic themes (Vinyl, CD, Polaroid, Cyberpunk, and more).

• 🎧 Smart Playback & Library Management

  • Versatile Player: Play from Local Drives or stream via SMB, WebDav, and FTP. Features playback memory to resume where you left off.
  • Live Library Sync: A high-performance media library that stays in sync with your local folder changes in real-time.
  • Universal Integration: Seamlessly visualizes music from Spotify, Apple Music, NetEase, and many other players.
  • Social Presence: Show what you're looping with Discord Rich Presence and sync your journey via Last.fm scrobbling.

• 🌐 Precision Lyrics & Plugin System

  • Smart Matching: Accurate matching with customizable thresholds, manual metadata mapping, and persistent source memory.
  • Lyrics Refinement: Features noise reduction (filters non-lyric content) and Simplified/Traditional Chinese conversion.
  • Modular Architecture: A plugin system for community-driven expansion of lyric sources, translation engines, and transliteration tools (e.g., Romaji).
  • Translation & AI Ready: Built-in offline translation with a framework ready for Local LLM (AI) integration via plugins.
  • Core Support: Native handling of .lrc (Standard/Enhanced), .eslrc, and .ttml formats.

• 🪟 Adaptive Modes for Every Setup

  • Standard / Full Screen: For a pure, immersive focus on the music.
  • Desktop / Wallpaper: Floating "Always-on-Top" window or embedded behind icons—perfect for creative Wallpaper Engine setups.
  • Docked: A dedicated, sleek Appbar that snaps to the top or bottom edge of your screen.
  • Narrow: Optimized for vertical layouts, featuring track info at the top and a massive, high-density lyric area.
  • Taskbar: Save your desktop real estate by living directly inside the Windows Taskbar.

• 🧠 Intelligence & Analytics

  • Smart Automation: Automatically stays out of your way by hiding when the music stops.
  • Stats Dashboard: A beautiful analytics hub to track your play history and rediscover your top artists and tracks.

🖼️ Screenshots

<img src="docs/assets/screenshots/std.png" width="50%"><img src="docs/assets/screenshots/narrow.png" width="50%"> <img src="docs/assets/screenshots/effect.png" width="50%"><img src="docs/assets/screenshots/all-in-one.png" width="50%"> <img src="docs/assets/screenshots/fs3.png" width="50%"><img src="docs/assets/screenshots/fs2.png" width="50%"> <img src="docs/assets/screenshots/music-gallery.png" width="50%"><img src="docs/assets/screenshots/stats.png" width="50%">

🎴 Lyrics Card

<img src="docs/assets/screenshots/card-feat.png"> <details><summary>👉 Click here to see all the styles</summary>

Classic Design

<img src="docs/assets/screenshots/card-0.png">

Physical

<img src="docs/assets/screenshots/card-1.png">

Digital Retro

<img src="docs/assets/screenshots/card-2.png">

Atmosphere

<img src="docs/assets/screenshots/card-3.png">

Chinese Elegance

<img src="docs/assets/screenshots/card-4.png">

Traces of Time

<img src="docs/assets/screenshots/card-5.png"> </details>

📹 Demonstration

Watch our demo video (uploaded on 21 Oct 2025) on Bilibili here.

✍️ Contribute & Build

Help us translate: Cannot find your language? Start translating here.

Develop Plugins: Want to extend functionality? 🧩 Read the Developer Guide.

Build from source:

Before building, ensure you have replaced DiscordTemplate.cs and LastFM.cs in the Constants folder.

🤑 Donations

If you like BetterLyrics, please consider supporting it. Your support helps keep the project alive!

<div align="center">

| Web Platforms | Alipay (QR) | WeChat (QR) | | :---: | :---: | :---: | | PayPal<br><br>Buy Me a Coffee<br><br>爱发电 (Afdian) | <img src="docs/assets/donate/Alipay.jpg" width="150"> | <img src="docs/assets/donate/WeChatReward.png" width="150"> |

View the full Hall of Fame (Sponsors)

</div>

⭐ Star History

<div align="center"> <img src="https://api.star-history.com/svg?repos=jayfunc/BetterLyrics&type=Date" width="100%"> </div>

📄 License & Credits

This project is licensed under the GNU General Public License v3.0.

💖 Special Thanks, Credits & Inspiration

Acknowledgments

Contributors

• [jayfunc](https://g