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

<div align="center">
  <img src="docs/assets/promotion/logo.png" alt="BetterLyrics Logo" width="120">
  
  <h1>BetterLyrics</h1>

  <h3>Strums the Heartstrings, Graces the Wordscapes</h3>

  <p>
    An elegant, highly customizable lyrics visualizer and versatile music player built with WinUI 3 & Win2D
  </p>

  <p>
    <a href="https://github.com/jayfunc/BetterLyrics/stargazers"><img src="https://img.shields.io/github/stars/jayfunc/BetterLyrics" alt="Stars"></a>
    <a href="https://github.com/jayfunc/BetterLyrics/releases/latest"><img src="https://img.shields.io/github/downloads/jayfunc/BetterLyrics/total?label=Downloads" alt="Downloads"></a>
    <img src="https://img.shields.io/badge/Language-C%23-purple" alt="C#">
    <a href="https://github.com/jayfunc/BetterLyrics/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-GPL_v3.0-blue" alt="License"></a>
    <a href="https://betterlyrics.github.io"><img alt="Official Website" src="https://img.shields.io/github/actions/workflow/status/BetterLyrics/BetterLyrics.github.io/pages%2Fpages-build-deployment?label=Official%20Website"></a>
  </p>
  <p>
    <a href="https://trendshift.io/repositories/16452" target="_blank"><img src="https://trendshift.io/api/badge/repositories/16452" alt="Trendshift" height="40"/></a>
    <a href="https://trendshift.io/repositories/16452?utm_source=trendshift-badge&amp;utm_medium=badge&amp;utm_campaign=badge-trendshift-16452" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/trendshift/repositories/16452/daily?language=C%23" alt="jayfunc%2FBetterLyrics | Trendshift" height="40"/></a>
  </p>

  <img src="docs/assets/promotion/banner.png" alt="Banner" width="100%" style="border-radius: 10px;">
  
</div>

---

## Table of Contents

- [Highlighted Features](#highlighted-features)
- [Download & Install](#download--install)
- [Screenshots](#screenshots)
- [Community](#community)
- [Contribute & Build](#contribute--build)
- [Donations](#donations)
- [Star History](#star-history)
- [Media Mentions & Community Features](#media-mentions--community-features)
- [License & Credits](#license--credits)
- [Share on Social Media](#share-on-social-media)

---

## Highlighted Features

### Stunning Visuals & Fluid Interactions
- **Powered by WinUI 3 & Win2D:** Experience buttery-smooth animations and hardware-accelerated rendering tailored for the modern Windows 11 design language.
- **Advanced Lyric Motion:** Breathe life into every word with **per-syllable karaoke highlighting**, trailing long-note glows, and spatial perspective fading for distant lyrics.
- **Immersive Dynamic Backgrounds:** Elevate your music with real-time audio visualizers and striking backgrounds—from fluid gradients to blur, fog, and snowflake particles.
- **Chameleon Adaptive Engine:** Intelligently samples colors from your screen edges or album art, ensuring the player perfectly blends with your desktop environment.

### Ultimate Ecosystem & Smart Automation
- **Universal Visualizer:** Flawlessly syncs with local libraries, SMB/FTP streams, and dozens of major platforms including Spotify, Apple Music, and NetEase.
- **Any-Scenario Layouts:** Choose your vibe: immersive Full Screen, floating Desktop mode, a discreet Taskbar integration, or a Wallpaper mode that embeds right beneath your icons (Wallpaper Engine friendly).
- **Precision Matching & AI-Ready:** High-accuracy lyric matching with automatic metadata correction and noise reduction. Built with a modular architecture ready for offline translations and Local LLM integrations.
- **Community Plugin System:** Expand BetterLyrics endlessly. Add custom lyric sources, transliterations (like Romaji), and translation engines via community-built plugins.
- **Artistic Lyrics Cards & Analytics:** Share your favorite lines using 10+ artistic templates (Vinyl, Polaroid, Cyberpunk), and explore your listening habits through a beautiful "Wrapped-style" stats story.

---

## 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" alt="Get it from Microsoft"/></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/docs/get-started/install) |

**[Docs](https://betterlyrics.github.io) | [Plugin Store](https://betterlyrics.github.io/docs/add-ons/plugins-store) | [Privacy Policy](docs/PRIVACY_POLICY.md) | [Terms of Service](docs/TERMS_OF_SERVICE.md)**

</div>

---

## Screenshots

<p align="center">
  <img src="docs/assets/screenshots/std.png" width="49%">
  <img src="docs/assets/screenshots/narrow.png" width="49%">
</p>

<details>
<summary><b>Click here to view more screenshots</b></summary>
<br>

<p align="center">
  <img src="docs/assets/screenshots/effect.png" width="49%">
  <img src="docs/assets/screenshots/all-in-one.png" width="49%">
  <br>
  <img src="docs/assets/screenshots/fs3.png" width="49%">
  <img src="docs/assets/screenshots/fs2.png" width="49%">
  <br>
  <img src="docs/assets/screenshots/music-gallery.png" width="49%">
  <img src="docs/assets/screenshots/stats.png" width="49%">
</p>

</details>

### Lyrics Card

<p align="center">
  <img src="docs/assets/screenshots/card-feat.png" alt="Lyrics Card Feature">
</p>

<details>
<summary><b>Click here to view all card styles</b></summary>
<br>

#### 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 on Bilibili [here](https://www.bilibili.com/video/BV1QRstz1EGt/).

---

## Community

Join our communities to get support, share your layouts, and stay updated:

<div align="center">

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

</div>

---

## Contribute & Build

We welcome community contributions! Here is how you can help:

- **Help us translate:** Cannot find your language? [Start translating here](https://crowdin.com/project/betterlyrics).
- **Develop Plugins:** Want to extend functionality? [Read the Developer Guide](https://betterlyrics.github.io/docs/plugin-dev/intro).
- **Build from source:** [View build instructions](https://betterlyrics.github.io/docs/get-started/download.html#visual-studio).

---

## Donations

If you enjoy using BetterLyrics, please consider supporting the project. Your contributions help keep the development active!

<div align="center">

| Web Platforms | Alipay / WeChat Pay |
| :---: | :---: |
| [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/donation/alipay_wechatpay.png" height="250" alt="Alipay and WeChat Pay QR Codes"> |

**[View the full Hall of Fame (Sponsors)](docs/SPONSORS.md)**

</div>

---

## Star History

<a href="https://star-history.dera.page/#jayfunc/BetterLyrics&type=Date">
 <picture>
   <source media="(prefers-color-scheme: dark)" srcset="https://star-history.dera.page/svg?repos=jayfunc/BetterLyrics&type=Date&theme=dark" />
   <source media="(prefers-color-scheme: light)" srcset="https://star-history.dera.page/svg?repos=jayfunc/BetterLyrics&type=Date" />
   <img alt="Star History Chart" src="https://star-history.dera.page/svg?repos=jayfunc/BetterLyrics&type=Date" />
 </picture>
</a>

---

## Media Mentions & Community Features

<div align="center">

<p>
  <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"></a>
  <a href="https://atomgit.com/jayfunc/BetterLyrics" target="_blank"><img src="https://atomgit.com/jayfunc/BetterLyrics/star/new_badge.svg" alt="AtomGit G-Star"></a>
</p>

</div>

Discover what the community and media are saying about BetterLyrics! Check out our full [Media & Community Features List](docs/MEDIA.md).

---

## License & Credits

This project is licensed under the **[GNU General Public License v3.0](LICENSE)**.

### Special Thanks, Credits & Inspiration

#### Contributors

##### Core Maintainer

| Maintainer | Roles |
| :--- | :--- |
| **[jayfunc](https://github.com/jayfunc)** | Core Developer / Project Lead (`C` `I` `Q` `D`) |

##### Contributors (Alphabetical)

| Contributor | Contributions |
| :--- | :--- |
| [borcolasky](https://crowdin.com/profile/borcolasky) | `I` |
| [H-MAli](https://github.com/H-MAli) | `C` |
| [kusutori](https://github.com/kusutori) | `C` |
| [PiYuanZhouLv](https://github.com/PiYuanZhouLv) | `C` |
| [Raspberry-Monster](https://github.com/Raspberry-Monster) | `C` |
| [SuHeAndZl](https://crowdin.com/profile/SuHeAndZl) | `I` `Q` `D` |
| [YUZU384](https://github.com/YUZU384) | `C` |
| [ZHider](https://github.com/ZHider) | `C` |
| [zxbmmmmmmmmm](https://github.com/zxbmmmmmmmmm) | `C` |

> `C` Code ╹ `I` i18n ╹ `Q` QA ╹ `D` Docs

#### Dependencies

| Projects / Packages | Description |
| :--- | :--- |
| [ComputeSharp](https://github.com/Sergio0694/ComputeSharp) | .NET library to run HLSL compute shaders, used for dynamic fluid backgrounds |
| [Dubya.WindowsMediaController](https://github.com/DubyaDude/WindowsMediaController) | Interacts with Windows 10/11 Media Transport Controls (SMTC) |
| [Lyricify-Lyrics-Helper](https://github.com/WXRIW/Lyricify-Lyrics-Helper) | Lyrics fetch, decryption, and parsing for various sources |
| [NAudio](https://github.com/naudio/NAudio) | Audio playback and WASAPI loopback for spectrum visualization |
| [Win2D](https://github.com/microsoft/Win2D) | Hardware-accelerated 2D graphics rendering for WinUI |

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

#### References

| Projects / Repositories | Description |
| :--- | :--- |
| [Isolation](https://github.com/Storyteller-Studios/Isolation) | Dynamic fluid background implementation |
| [LibreTranslate](https://github.com/LibreTranslate/LibreTranslate) | Offline lyrics translation provider |
| [lrclib](https://github.com/tranxuanthang/lrclib) | LRCLIB lyrics API provider |
| [Manzana-Apple-Music-Lyrics](https://github.com/dropcreations/Manzana-Apple-Music-Lyrics) | Apple Music lyrics fetch using Python |
| [original-sound-hq-player](https://github.com/Johnwikix/original-sound-hq-player) | Apple Music style spring animation for lyrics scrolling reference |
| [SpectrumVisualization](https://github.com/Johnwikix/SpectrumVisualization) | Audio visualization reference |

#### Inspired By

Some design ideas are referenced from the following projects (design inspiration only):

| Projects / Software | Description |
| :--- | :--- |
| [FluentFlyout](https://github.com/unchihugo/FluentFlyout) `FOSS` | Interaction and visual design concepts of the Now Playing flyout |
| [refined-now-playing-netease](https://github.com/solstice23/refined-now-playing-netease) `FOSS` | Overall layout and typography design of the standard mode lyrics interface |
| [Lyricify-App](https://github.com/WXRIW/Lyricify-App) `Prop` | Architectural approach to monitoring and handling multiple media sessions via SMTC |
| [Salt Player for Windows](https://moriafly.com/program/spw.html) `Paid` `Prop` | Mouse hover parallax animation for album covers, and UI element designs in the now-playing bar |
| [MyToolBar](https://github.com/TwilightLemon/MyToolBar) `FOSS` | AppBar concept, which inspired the interaction logic of the "Docked Mode" in this project |

> `FOSS` Free and Open Source Software ╹ `Prop` Proprietary ╹ `Paid` 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">
  <sub>Thunder Bay × Wuhan</sub><br>
  <sub>© 2025-2026 The BetterLyrics Contributors. All rights reserved.</sub><br>
  <sub>Disclaimer: This project is provided "as is". All third-party resources belong to their respective owners.</sub>
</div>