**English** | [**中文**](README.CN.md)

<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**](https://sspai.com/post/101028) | [![DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/jayfunc/BetterLyrics) <br> [![Zread](https://img.shields.io/badge/Ask_Zread-_.svg?style=flat&color=00b0aa&labelColor=000000&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTQuOTYxNTYgMS42MDAxSDIuMjQxNTZDMS44ODgxIDEuNjAwMSAxLjYwMTU2IDEuODg2NjQgMS42MDE1NiAyLjI0MDFWNC45NjAxQzEuNjAxNTYgNS4zMTM1NiAxLjg4ODEgNS42MDAxIDIuMjQxNTYgNS42MDAxSDQuOTYxNTZDNS4zMTUwMiA1LjYwMDEgNS42MDE1NiA1LjMxMzU2IDUuNjAxNTYgNC45NjAxVjIuMjQwMUM1LjYwMTU2IDEuODg2NjQgNS4zMTUwMiAxLjYwMDEgNC45NjE1NiAxLjYwMDFaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00Ljk2MTU2IDEwLjM5OTlIMi4yNDE1NkMxLjg4ODEgMTAuMzk5OSAxLjYwMTU2IDEwLjY4NjQgMS42MDE1NiAxMS4wMzk5VjEzLjc1OTlDMS42MDE1NiAxNC4xMTM0IDEuODg4MSAxNC4zOTk5IDIuMjQxNTYgMTQuMzk5OUg0Ljk2MTU2QzUuMzE1MDIgMTQuMzk5OSA1LjYwMTU2IDE0LjExMzQgNS42MDE1NiAxMy43NTk5VjExLjAzOTlDNS42MDE1NiAxMC42ODY0IDUuMzE1MDIgMTAuMzk5OSA0Ljk2MTU2IDEwLjM5OTlaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik0xMy43NTg0IDEuNjAwMUgxMS4wMzg0QzEwLjY4NSAxLjYwMDEgMTAuMzk4NCAxLjg4NjY0IDEwLjM5ODQgMi4yNDAxVjQuOTYwMUMxMC4zOTg0IDUuMzEzNTYgMTAuNjg1IDUuNjAwMSAxMS4wMzg0IDUuNjAwMUgxMy43NTk5QzE0LjExMTkgNS42MDAxIDE0LjM5ODQgNS4zMTM1NiAxNC4zOTg0IDQuOTYwMVYyLjI0MDFDMTQuMzk4NCAxLjg4NjY0IDE0LjExMTkgMS42MDAxIDEzLjc1ODQgMS42MDAxWiIgZmlsbD0iI2ZmZiIvPgo8cGF0aCBkPSJNNCAxMkwxMiA0TDQgMTJaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00IDEyTDEyIDQiIHN0cm9rZT0iI2ZmZiIgc3Ryb2tlLXdpZHRoPSIxLjUiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIvPgo8L3N2Zz4K&logoColor=ffffff)](https://zread.ai/jayfunc/BetterLyrics) |

**Chat Groups:** 
[QQ Group 1](https://qm.qq.com/q/yArcw3n8pq) (1054700388) | [QQ Group 2](https://qm.qq.com/q/27rzSjFXt6) (1076554669) | [QQ Channel (BetterLyrics4U)](https://pd.qq.com/s/1u1ntkyzr?b=9) | [Discord](https://discord.gg/5yAQPnyCKv) | [Telegram](https://t.me/+svhSLZ7awPsxNGY1)

</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)**](https://github.com/jayfunc/BetterLyrics/releases/latest)<br>See [Installation Guide](https://betterlyrics.github.io/get-started/install) |

[📖 Docs](https://betterlyrics.github.io) | [🧩 Plugin Store](https://betterlyrics.github.io/plugins-store) | [🔒 Privacy Policy](docs/PRIVACY_POLICY.md) | [⚖️ Terms of Service](docs/TERMS_OF_SERVICE.md)

</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](https://betterlyrics.github.io/player-cfg).
  - **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](https://www.bilibili.com/video/BV1QRstz1EGt/).

## ✍️ Contribute & Build

**Help us translate:** Cannot find your language? [Start translating here](https://github.com/jayfunc/BetterLyrics?tab=contributing-ov-file).

**Develop Plugins:** Want to extend functionality? [🧩 Read the Developer Guide](https://betterlyrics.github.io/plugin-dev/intro/).

**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](https://paypal.me/zhefangpay)<br><br>[Buy Me a Coffee](https://buymeacoffee.com/founchoo)<br><br>[爱发电 (Afdian)](https://afdian.com/a/jayfunc) | <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)](docs/SPONSORS.md)**

</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://github.com/jayfunc) `💻` `🌐` `🧪` `📝`
* [Raspberry-Monster](https://github.com/Raspberry-Monster) `💻`
* [zxbmmmmmmmmm](https://github.com/zxbmmmmmmmmm) `💻`
* [ZHider](https://github.com/ZHider) `💻`
* [YUZU384](https://github.com/YUZU384) `💻`
* [kusutori](https://github.com/kusutori) `💻`
* [PiYuanZhouLv](https://github.com/PiYuanZhouLv) `💻`
* [SuHeAndZl](https://crowdin.com/profile/SuHeAndZl) `🌐` `🧪` `📝`
* [borcolasky](https://crowdin.com/profile/borcolasky) `🌐`

> `💻` Code ╹ `🌐` i18n ╹ `🧪` QA ╹ `📝` Docs

#### Sponsors

* Special thanks to everyone who has supported the project through donations. For full details, please refer to the [Sponsors List (Hall of Fame)](docs/SPONSORS.md).

### Dependencies & References

| Projects/Packages | Description |
| :--- | :--- |
| [Isolation](https://github.com/Storyteller-Studios/Isolation) | Dynamic fluid background implementation |
| [LibreTranslate](https://github.com/LibreTranslate/LibreTranslate) | Provide the ability for offline lyrics translation |
| [lrclib](https://github.com/tranxuanthang/lrclib) | LRCLIB lyrics API provider |
| [Lyricify-Lyrics-Helper](https://github.com/WXRIW/Lyricify-Lyrics-Helper) | Provide lyrics fetch, decryption, and parsing for QQ, Netease, and Kugou sources |
| [Manzana-Apple-Music-Lyrics](https://github.com/dropcreations/Manzana-Apple-Music-Lyrics) | Apple Music lyrics fetch using Python |
| [SpectrumVisualization](https://github.com/Johnwikix/SpectrumVisualization) | Audio visualization reference |

See [dependencies](https://github.com/jayfunc/BetterLyrics/network/dependencies) for the full list.

### Inspired by

Some design ideas are referenced from the following projects (design inspiration only):
- [refined-now-playing-netease](https://github.com/solstice23/refined-now-playing-netease) `FOSS`
- [Lyricify-App](https://github.com/WXRIW/Lyricify-App) `Prop`
- [Salt Player for Windows](https://moriafly.com/program/spw.html) `💰` `Prop`
- [MyToolBar](https://github.com/TwilightLemon/MyToolBar) `FOSS`

> `FOSS` Free and Open Source Software ╹ `Prop` Proprietary ╹ `💰` Paid

## 💭 Share on Social Media

<details>
<summary><b>Click to expand</b></summary>
<br>
<div align="center">
  <img src="https://socialify.git.ci/jayfunc/BetterLyrics/image?description=1&forks=1&issues=1&language=1&name=1&owner=1&pulls=1&stargazers=1&theme=Light" width="48%">
  <img src="https://opengraph.githubassets.com/<any_hash_number>/jayfunc/BetterLyrics" width="48%">
</div>
</details>

<br>

<div align="center">
  <mark><i>This project is under active development; unexpected issues may occur.</i></mark><br>
  <sub>Disclaimer: This project is provided "as is". All third-party resources belong to their respective owners.</sub>
</div>
