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

<div align="center">
  <img src="BetterLyrics.WinUI3/Assets/Logo.png" alt="Logo" width="120">
  
  <h1>BetterLyrics</h1>

  <h3>曲拨心弦，词落云笺</h3>

  <h4>
    一款优雅且高度自定义的歌词可视化与全能音乐播放应用<br>基于 WinUI3 / Win2D 构建
  </h4>

  <div>
    <img src="https://img.shields.io/badge/语言-C%23-purple" alt="C#">
    <img src="https://img.shields.io/badge/框架-WinUI%203-blue" alt="WinUI 3">
    <img src="https://img.shields.io/badge/许可证-GPL_v3.0-blue" alt="License">
    <a href="https://github.com/jayfunc/BetterLyrics/stargazers"><img src="https://img.shields.io/github/stars/jayfunc/BetterLyrics?label=%E6%98%9F%E6%A0%87%E6%95%B0" alt="Star"></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=%E5%AE%98%E7%BD%91"></a>
    <a href="https://github.com/jayfunc/BetterLyrics/releases/latest"><img src="https://img.shields.io/github/downloads/jayfunc/BetterLyrics/total?label=%E4%B8%8B%E8%BD%BD%E9%87%8F"><a/>
  </div>

  <br>

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

</div>

<br>

## 🔥 精选推荐与社区

<div align="center">

| HelloGitHub 推荐 | 少数派 SSPAI 推荐 | 🤖 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> | [**阅读评测文章**](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) |

**交流群：** [QQ 群 1](https://qm.qq.com/q/yArcw3n8pq) (1054700388) | [QQ 群 2](https://qm.qq.com/q/27rzSjFXt6) (1076554669) | [QQ 频道（BetterLyrics4U）](https://pd.qq.com/s/1u1ntkyzr?b=9) | [Discord](https://discord.gg/5yAQPnyCKv) | [Telegram](https://t.me/+svhSLZ7awPsxNGY1)

</div>

## 🧪 下载与安装

<div align="center">

| Microsoft Store (推荐) | 手动安装 |
| :---: | :---: |
| <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>无限期免费试用（功能与付费版一致） | [**📦 最新版本 (.zip)**](https://github.com/jayfunc/BetterLyrics/releases/latest)<br>[查看安装指南](https://betterlyrics.github.io/zh-cn/get-started/install) |

[📖 使用文档](https://betterlyrics.github.io/zh-cn) | [🧩 插件商店](https://betterlyrics.github.io/zh-cn/plugins-store) | [🔒 隐私政策](docs/PRIVACY_POLICY.CN.md) | [⚖️ 服务条款](docs/TERMS_OF_SERVICE.CN.md)

</div>

## 🌟 核心特性

- 🎨 **惊艳视觉与灵动歌词**
  - **流畅界面：** 基于 WinUI 3 与 Win2D 打造的现代交互体验，拥有丝滑的动画效果与深度定制选项。
  - **高阶歌词动效：** 让每一个字符随音乐律动。包含**逐音节高亮**、**长音余韵发光**以及远端歌词的**透视淡出**效果。
  - **全方位视觉掌控：** 除去预设方案，你还可以微调歌词动画、字体及各类视觉行为，打造专属你的独特风格。
  - **沉浸式背景：** 包含流体渐变、动态模糊、迷雾以及雪花粒子等多种精美视觉特效。
  - **音频频谱：** 内置实时音频频谱分析器，让音乐节奏清晰可见。
  - **歌词卡片：** 支持生成并分享精美的歌词卡片，内置黑胶、CD、拍立得、赛博朋克等 10 余种艺术主题。

- 🎧 **智能播放与媒体库管理**
  - **全能播放器：** 支持播放**本地驱动器**或通过 **SMB、WebDav、FTP** 协议远程串流。支持**断点续播**，自动回到上次停止的位置。
  - **媒体库实时同步：** 高性能媒体库能够实时监控并同步本地文件夹的所有变更。
  - **广泛的外部集成：** 适配并可视化来自 Spotify、Apple Music、网易云音乐及 [众多主流播放器](https://betterlyrics.github.io/zh-cn/player-cfg) 的音频。
  - **社交状态展示：** 支持 **Discord Rich Presence** 实时展示听歌状态，并支持 **Last.fm** 数据上报。

- 🌐 **精准歌词与插件系统**
  - **智能匹配：** 高准确率的歌词匹配逻辑，支持**自定义匹配阈值**、手动映射歌曲信息，并拥有能记住你手动选择的歌词源记忆功能。
  - **歌词去杂精炼：** 支持**非正文内容过滤**（去除无关噪音信息）以及**简繁体强制转换**。
  - **模块化插件架构：** 强大的插件系统，支持社区驱动扩展歌词源、翻译引擎及音译工具（如日文罗马音）。
  - **翻译与 AI 接入：** 内置离线机器翻译，并提供开放框架，支持通过插件接入**本地大语言模型**实现前沿 AI 翻译。
  - **原生格式支持：** 原生兼容 `.lrc` (标准/增强型)、`.eslrc` 以及 `.ttml` 歌词格式。

- 🪟 **全场景自适应模式**
  - **标准 / 全屏模式：** 提供最纯粹、沉浸的音乐享受空间。
  - **桌面 / 壁纸模式：** 可选择 “永远置顶” 的悬浮窗口，或选择**嵌入桌面图标底层**——完美适配 **Wallpaper Engine** 联动。
  - **停靠模式：** 专用的 AppBar 侧边栏，可优雅地贴靠在屏幕顶部或底部。
  - **窄屏模式：** 专为竖屏优化，上方显示歌曲信息，下方提供超大面积的歌词显示。
  - **任务栏模式：** 将歌词直接嵌入 Windows 任务栏，在不占用桌面空间的同时掌控律动。

- 🧠 **智能交互与数据统计**
  - **智能自动化：** 音乐停止时自动隐藏，绝不干扰你的日常工作。
  - **数据统计面板：** 精美的统计中心，带你回顾听歌历史，发现你的年度最佳歌手与单曲。

## 🖼️ 软件截图

<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%">

### 🎴 歌词卡片

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

<details><summary>👉 点按此处查看所有样式</summary>

### 经典设计

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

### 实体质感

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

### 数码怀旧

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

### 氛围创意

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

### 国风雅韵

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

### 时光印记

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

</details>

## 📹 演示视频

> 观看我们在 Bilibili 发布的演示视频（上传于 2025 年 10 月 21 日）：[点击观看](https://www.bilibili.com/video/BV1QRstz1EGt/)。

## ✍️ 贡献与构建

**协助翻译：** 找不到你的语言？[点此开始翻译](https://github.com/jayfunc/BetterLyrics?tab=contributing-ov-file)。

**开发插件：** 想要扩展功能？[🧩 阅读插件开发指南](https://betterlyrics.github.io/zh-cn/plugin-dev/intro/)。

**从源码构建：**
> 构建前，请确保已替换 `Constants` 文件夹下的 `DiscordTemplate.cs` 和 `LastFM.cs`。

## 🤑 赞助与捐赠

如果你喜欢 BetterLyrics，请考虑支持它。你的支持有助于项目持续发展！

<div align="center">

| 网页平台 | 支付宝 (扫码) | 微信 (扫码) |
| :---: | :---: | :---: |
| [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"> |

[赞助者名单 (Hall of Fame)](docs/SPONSORS.md)

</div>

## ⭐ Star 历史趋势

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

## 📄 许可与致谢

本项目采用 **GNU General Public License v3.0** 许可证。

## 💖 特别致谢、引用与灵感

### 鸣谢

#### 贡献者

* [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

#### 赞助名单

- 感谢所有购买打赏支持的朋友，详情请见 [赞助者名单 (Hall of Fame)](docs/SPONSORS.md)。

### 依赖与引用

| 项目/包 (Projects/Packages) | 描述 (Description) |
| :--- | :--- |
| [Isolation](https://github.com/Storyteller-Studios/Isolation) | 动态流体背景的实现 |
| [LibreTranslate](https://github.com/LibreTranslate/LibreTranslate) | 提供离线歌词翻译功能 |
| [lrclib](https://github.com/tranxuanthang/lrclib) | LRCLIB 歌词 API 数据源 |
| [Lyricify-Lyrics-Helper](https://github.com/WXRIW/Lyricify-Lyrics-Helper) | 提供 QQ、网易云音乐和酷狗音乐源的歌词抓取、解密及解析功能 |
| [Manzana-Apple-Music-Lyrics](https://github.com/dropcreations/Manzana-Apple-Music-Lyrics) | 使用 Python 获取 Apple Music 歌词 |
| [SpectrumVisualization](https://github.com/Johnwikix/SpectrumVisualization) | 音频频谱可视化参考 |

查看 [完整依赖列表](https://github.com/jayfunc/BetterLyrics/network/dependencies)。

### 灵感来源

部分设计理念参考了以下插件/软件（仅作为设计思路参考，不涉及代码引用）：
- [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) `💰` `Prop`
- [MyToolBar](https://github.com/TwilightLemon/MyToolBar) `FOSS`

> `FOSS` 开源 ╹ `Prop` 闭源 ╹ `💰` 付费

## 💭 分享到社交媒体

<details>
<summary><b>点击展开</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>本项目正处于积极开发阶段；可能会出现意外问题。</i></mark><br>
  <sub>免责声明：本项目“按原样”提供。所有第三方资源归其各自所有者所有。</sub>
</div>
