mirror of
https://github.com/jayfunc/BetterLyrics.git
synced 2026-01-12 10:54:55 +08:00
186 lines
10 KiB
Markdown
186 lines
10 KiB
Markdown
**中文** | [**English**](README.md)
|
||
|
||
<div align="center">
|
||
<img src="BetterLyrics.WinUI3/BetterLyrics.WinUI3/Assets/Logo.png" alt="Logo" width="120">
|
||
|
||
<h1>BetterLyrics</h1>
|
||
|
||
<h4>
|
||
🤩 一款优雅且高度自定义的歌词可视化与全能音乐播放应用 <br>
|
||
基于 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>
|
||
</div>
|
||
|
||
<br>
|
||
|
||
<img src="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) | [](https://deepwiki.com/jayfunc/BetterLyrics) <br> [](https://zread.ai/jayfunc/BetterLyrics) |
|
||
|
||
**交流群：** [QQ 群（1054700388）](https://qun.qq.com/universal-share/share?ac=1&authKey=4Q%2BYTq3wZldYpF5SbS5c19ECFsiYoLZFAIcBNNzYpBUtiEjaZ8sZ%2F%2BnFN0qw3lad&busi_data=eyJncm91cENvZGUiOiIxMDU0NzAwMzg4IiwidG9rZW4iOiJiVnhqemVYN0N5QVc3b1ZkR24wWmZOTUtvUkJoWm1JRWlaWW5iZnlBcXJtZUtGc2FFTHNlUlFZMi9iRm03cWF5IiwidWluIjoiMTM5NTczOTY2MCJ9&data=39UmAihyH_o6CZaOs7nk2mO_lz2ruODoDou6pxxh7utcxP4WF5sbDBDOPvZ_Wqfzeey4441anegsLYQJxkrBAA&svctype=4&tempid=h5_group_info) | [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://www.cnblogs.com/jayfunc/p/19212078) |
|
||
|
||
[📖 用户指南](https://github.com/jayfunc/BetterLyrics/wiki/使用指南) | [🔒 隐私政策](PrivacyPolicy.CN.md) | [⚖️ 服务条款](TermsofService.CN.md)
|
||
|
||
</div>
|
||
|
||
## 🌟 核心功能
|
||
|
||
- 🎨 **绝美视觉与 UI**
|
||
- **优雅设计：** 基于 WinUI3 & Win2D 的流畅、高度个性化风格。
|
||
- **沉浸特效：** 支持流体背景、3D/扇形歌词、雪花粒子等多种效果。
|
||
- **深度定制：** 按需配置动画、字体和行为逻辑，打造你的专属播放器。
|
||
|
||
- 🎧 **多功能播放与连接**
|
||
- **内置播放器：** 支持播放 **本地硬盘** 文件或通过 **网络协议** (SMB, WebDAV) 流式播放。
|
||
- **外部集成：** 可视化来自 Spotify, Apple Music, 网易云音乐及 [其他多种播放器](https://github.com/jayfunc/BetterLyrics/wiki/使用指南#已知支持的音乐播放器配置指南) 的音乐。
|
||
|
||
- 🌐 **强大的歌词系统**
|
||
- **离线翻译：** 注重隐私的本地机器翻译（支持 30+ 种语言）。
|
||
- **全面源支持：** 支持 .lrc (标准/增强), .eslrc, .ttml, 内嵌标签，以及在线源（QQ 音乐, 网易云, LRCLIB）。
|
||
- **Apple Music：** 支持歌词获取（需配置 Token）。
|
||
|
||
- 🪟 **全场景显示模式**
|
||
- **标准模式：** 全屏沉浸式体验。
|
||
- **停靠模式：** 贴附于屏幕边缘的精致侧边栏。
|
||
- **桌面悬浮：** 悬浮于所有应用之上的歌词挂件。
|
||
|
||
- 🧠 **智能行为**
|
||
- 音乐暂停时自动隐藏。
|
||
|
||
## 🖼️ 软件截图
|
||
|
||
<div align="center">
|
||
|
||
| 标准视图 | 侧边栏模式 |
|
||
| :---: | :---: |
|
||
| <img src="Screenshots/std.png" width="100%"> | <img src="Screenshots/narrow.png" width="100%"> |
|
||
|
||
| 歌词视觉特效 | 多模式共存 |
|
||
| :---: | :---: |
|
||
| <img src="Screenshots/effect.png" width="100%"> | <img src="Screenshots/all-in-one.png" width="100%"> |
|
||
|
||
| 全屏模式 | 全屏模式 |
|
||
| :---: | :---: |
|
||
| <img src="Screenshots/fs3.png" width="100%"> | <img src="Screenshots/fs2.png" width="100%"> |
|
||
|
||
| 音乐库 | 播放统计 |
|
||
| :---: | :---: |
|
||
| <img src="Screenshots/music-gallery.png" width="100%"> | <img src="Screenshots/stats.png" width="100%"> |
|
||
|
||
</div>
|
||
|
||
## 📹 演示视频
|
||
|
||
> 观看我们在 Bilibili 发布的演示视频（上传于 2025 年 10 月 21 日）：[点击观看](https://www.bilibili.com/video/BV1QRstz1EGt/)。
|
||
|
||
## ✍️ 贡献与构建
|
||
|
||
**协助翻译：** 找不到你的语言？[点此开始翻译](https://github.com/jayfunc/BetterLyrics?tab=contributing-ov-file)。
|
||
|
||
**从源码构建：**
|
||
> 构建前，请确保已替换 `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="Donate/Alipay.jpg" width="150"> | <img src="Donate/WeChatReward.png" width="150"> |
|
||
|
||
**[查看完整赞助者名单 (Hall of Fame)](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** 许可证。
|
||
|
||
<details>
|
||
<summary><b>💖 特别致谢、引用与灵感</b></summary>
|
||
<br>
|
||
|
||
**依赖与引用：**
|
||
|
||
| 项目/包 (Projects/Packages) | 描述 (Description) |
|
||
| :--- | :--- |
|
||
| [Audio Tools Library (ATL) for .NET](https://github.com/Zeugma440/atldotnet) | 用于从音乐文件中提取图片（封面） |
|
||
| [cutlet](https://github.com/polm/cutlet) | 提供将日语转换为罗马音 (Romaji) 的功能 |
|
||
| [DevWinUI](https://github.com/ghost1372/DevWinUI) | 为构建 WinUI 3 应用程序提供许多开箱即用的功能 |
|
||
| [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) | 音频频谱可视化参考 |
|
||
| [TagLib#](https://github.com/mono/taglib-sharp) | 用于读取原始歌词内容（元数据） |
|
||
| [Vanara](https://github.com/dahall/Vanara) | Win32 API 封装库 |
|
||
| [WinUIEx](https://github.com/dotMorten/WinUIEx) | 提供访问与窗口管理相关的 Win32 API 的便捷方式 |
|
||
|
||
查看 [完整依赖列表](https://github.com/jayfunc/BetterLyrics/network/dependencies)。
|
||
|
||
<br>
|
||
|
||
**💡 灵感来源：**
|
||
|
||
部分设计理念参考了以下插件/软件（仅作为设计思路参考，不涉及代码引用）：
|
||
- [refined-now-playing-netease](https://github.com/solstice23/refined-now-playing-netease)
|
||
- [Lyricify-App](https://github.com/WXRIW/Lyricify-App)
|
||
- [椒盐音乐 Salt Player](https://moriafly.com/program/salt-player)
|
||
- [MyToolBar](https://github.com/TwilightLemon/MyToolBar)
|
||
|
||
</details>
|
||
|
||
## 💭 分享到社交媒体
|
||
|
||
<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>
|