mirror of
https://github.com/jayfunc/BetterLyrics.git
synced 2026-01-12 10:54:55 +08:00
226 lines
12 KiB
Markdown
226 lines
12 KiB
Markdown
|
||
|
||
<div align=center>
|
||
<img src="BetterLyrics.WinUI3/BetterLyrics.WinUI3/Assets/Logo.png" alt="" width="96">
|
||
</div>
|
||
|
||
<h2 align=center>
|
||
BetterLyrics
|
||
</h2>
|
||
|
||
<h4 align="center">
|
||
🤩 一款优雅且高度自定义的歌词可视化与全能音乐播放应用，基于 WinUI3/Win2D 构建
|
||
</h4>
|
||
|
||
<div align="center">
|
||
|
||
[使用指南](https://github.com/jayfunc/BetterLyrics/wiki/使用指南) | [隐私政策](PrivacyPolicy.CN.md) | [服务协议](TermsofService.CN.md)
|
||
|
||
</div>
|
||
|
||
<div align=center>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
</div>
|
||
|
||
<div align=center>
|
||
|
||
[](https://github.com/jayfunc/BetterLyrics/stargazers)
|
||
[](https://crowdin.com/project/betterlyrics)
|
||
|
||
</div>
|
||
|
||
<div align=center>
|
||
|
||
[](https://deepwiki.com/jayfunc/BetterLyrics)
|
||
[](https://zread.ai/jayfunc/BetterLyrics)
|
||
|
||
</div>
|
||
|
||
<div align="center">
|
||
|
||
<mark>**_💞 BetterLyrics 的发展离不开每一位贡献者、反馈者和用户的全力支持。_**</mark>
|
||
|
||
<mark>**_项目持续活跃开发中，可能会遇到未知问题。_**</mark>
|
||
|
||
</div>
|
||
|
||
## ✍️ 协助翻译
|
||
|
||
找不到你的语言？有更好的翻译？没关系！😆 访问 [此处](https://github.com/jayfunc/BetterLyrics?tab=contributing-ov-file) 查看如何贡献翻译！
|
||
|
||
## 🎉 该项目入选 HelloGitHub 推荐！
|
||
|
||
<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="Featured｜HelloGitHub" style="width: 250px; height: 54px;" width="250" height="54" /></a>
|
||
|
||
## 🎉 该项目入选少数派推荐！
|
||
|
||
文章链接：[BetterLyrics - 一款专为 Windows 打造的沉浸式流畅歌词显示软件](https://sspai.com/post/101028)。
|
||
|
||
## 🔈 反馈交流群
|
||
|
||
[QQ 群](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) (1054700388) | [Discord Server](https://discord.gg/5yAQPnyCKv) | [Telegram Group](https://t.me/+svhSLZ7awPsxNGY1)
|
||
|
||
## 🌟 核心功能亮点
|
||
|
||
- 🎨 **惊艳的视觉体验**
|
||
- **优雅设计**：基于 WinUI3 与 Win2D 打造，风格丝滑流畅，支持高度个性化定制。
|
||
- **沉浸特效**：流体背景、3D/扇形歌词渲染、雪花粒子效果等。
|
||
- **深度定制**：动画、字体、交互行为均可随心配置。
|
||
|
||
- 🎧 **全能播放与连接**
|
||
- **内置播放器**：
|
||
- 直接播放 **本地硬盘** 音乐。
|
||
- 通过 **网络协议** (SMB, WebDAV) 流式传输。
|
||
- 支持读取音频文件的内嵌歌词。
|
||
- **外部集成**：
|
||
- 完美适配并可视化来自 Spotify, Apple Music, 网易云音乐及 [更多播放器](https://github.com/jayfunc/BetterLyrics/wiki/使用指南#已知支持的音乐播放器配置指南) 的音乐。
|
||
|
||
- 🌐 **强大的歌词系统**
|
||
- **离线翻译**：注重隐私的本地机器翻译（支持 30+ 种语言）。
|
||
- **全能歌词源**：
|
||
- 💾 **文件**：.lrc (标准/增强), .eslrc, .ttml 以及内嵌标签。
|
||
- ☁️ **在线**：QQ 音乐、网易云音乐、酷狗音乐、LRCLIB、amll-ttml-db。
|
||
- 🍎 **Apple Music**：（需额外配置 Token）。
|
||
|
||
- 🪟 **多场景显示模式**
|
||
- **标准模式**：完整的沉浸式视听体验。
|
||
- **停靠模式**：吸附在屏幕边缘的精致动态歌词栏。
|
||
- **桌面模式**：悬浮于所有应用之上的歌词挂件。
|
||
- ...更多模式等你探索。
|
||
|
||
- 🧠 **智能交互**
|
||
- 音乐暂停时自动隐藏。
|
||
|
||
## 🖼️ 屏幕截图
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
> ⚠️ 由于 GIF 格式帧率限制，效果仅作展示。请以实机效果为准。
|
||
|
||
|
||
|
||
|
||
## 📹 演示
|
||
|
||
在 [哔哩哔哩](https://www.bilibili.com/video/BV1QRstz1EGt/) 上观看于 2025 年 10 月 21 日上传的演示视频。
|
||
|
||
## 🧪 即刻体验
|
||
|
||
<a href="https://apps.microsoft.com/detail/9P1WCD1P597R?referrer=appbadge&mode=direct">
|
||
<img src="https://get.microsoft.com/images/zh-cn%20dark.svg" width="200"/>
|
||
</a>
|
||
|
||
**无限期**免费试用版和付费版**无任何区别**。
|
||
|
||
如果喜欢该软件，请考虑 [捐赠](#-捐赠) 或在 **Microsoft Store** 购买，感谢您的支持！ 🥰
|
||
|
||
无法从 Microsoft Store 下载？尝试以下方法：
|
||
- [从 Microsoft Store 外部下载](https://www.cnblogs.com/jayfunc/p/19212083)
|
||
- 转至 [最新发布页](https://github.com/jayfunc/BetterLyrics/releases/latest) 并从 `Assets`（资产）列表下载 `.zip` 文件。(安装方法参考 [此文档](https://www.cnblogs.com/jayfunc/p/19212078)。)
|
||
|
||
## 🏗️ 构建
|
||
|
||
在构建之前确保：
|
||
- 替换文件 `BetterLyrics\BetterLyrics.WinUI3\BetterLyrics.WinUI3\Constants\DiscordTemplate` 为 `BetterLyrics\BetterLyrics.WinUI3\BetterLyrics.WinUI3\Constants\DiscordTemplate.cs`.
|
||
- 替换文件 `BetterLyrics\BetterLyrics.WinUI3\BetterLyrics.WinUI3\Constants\LastFMTemplate` 为 `BetterLyrics\BetterLyrics.WinUI3\BetterLyrics.WinUI3\Constants\LastFM.cs`。
|
||
|
||
## 🤑 捐赠
|
||
|
||
如果你喜欢本应用，请考虑捐赠支持开发者。这将有助于本应用的长远发展。
|
||
|
||
通过以下途径捐赠：
|
||
- [PayPal](https://paypal.me/zhefangpay)
|
||
- [Buy Me a Coffee](https://buymeacoffee.com/founchoo)
|
||
- [爱发电](https://afdian.com/a/jayfunc)
|
||
- <details><summary>支付宝</summary>
|
||
|
||
|
||
|
||
</detais>
|
||
|
||
- <details><summary>微信</summary>
|
||
|
||
|
||
|
||
</details>
|
||
|
||
本项目的持续发展离不开大家的支持。**[查看完整鸣谢名单](SPONSORS.md)**
|
||
|
||
## 📄 许可证
|
||
|
||
本项目采用 GNU 通用公共许可证 v3.0 授权。详情请参阅 [LICENSE](https://github.com/jayfunc/BetterLyrics/blob/dev/LICENSE) 文件。
|
||
|
||
## 💖 感谢
|
||
|
||
部分功能及代码引用或修改自公开资料库，包括但不限于下述开源项目/包、教程等，在此一并感谢。
|
||
|
||
| 项目/包 | 描述 |
|
||
| :--- | :--- |
|
||
| [Lyricify-Lyrics-Helper](https://github.com/WXRIW/Lyricify-Lyrics-Helper) | 为 QQ、网易、酷狗在线歌词源提供歌词抓取、解密、解析等一系列方法 |
|
||
| [lrclib](https://github.com/tranxuanthang/lrclib) | LRCLIB 歌词 API |
|
||
| [Manzana-Apple-Music-Lyrics](https://github.com/dropcreations/Manzana-Apple-Music-Lyrics) | Apple Music 歌词抓取（Python 实现） |
|
||
| [Audio Tools Library (ATL) for .NET](https://github.com/Zeugma440/atldotnet) | 从音乐文件提取图片 |
|
||
| [WinUIEx](https://github.com/dotMorten/WinUIEx) | 提供有关窗口的开箱即用的 Win32 API |
|
||
| [TagLib#](https://github.com/mono/taglib-sharp) | 读取音乐文件内嵌的原始歌词内容 |
|
||
| [Vanara](https://github.com/dahall/Vanara) | 提供开箱即用的 Win32 API |
|
||
| [LibreTranslate](https://github.com/LibreTranslate/LibreTranslate) | 离线翻译核心 |
|
||
| [Isolation](https://github.com/Storyteller-Studios/Isolation) | 动态流体背景 |
|
||
| [SpectrumVisualization](https://github.com/Johnwikix/SpectrumVisualization) | 频谱图 |
|
||
| [DevWinUI](https://github.com/ghost1372/DevWinUI) | 为 WinUI3 提供众多开箱即用的功能 |
|
||
| ... | ... |
|
||
|
||
点按 [此处](https://github.com/jayfunc/BetterLyrics/network/dependencies) 查看所有依赖。
|
||
|
||
### 教程、博客等
|
||
|
||
- [Stackoverflow - How to animate Margin property in WPF](https://stackoverflow.com/a/21542882/11048731)
|
||
- [Bilibili -【WinUI3】SystemBackdropController：定义云母、亚克力效果](https://www.bilibili.com/video/BV1PY4FevEkS)
|
||
- [cnblogs - .NET App 与 Windows 系统媒体控制(SMTC)交互](https://www.cnblogs.com/TwilightLemon/p/18279496)
|
||
- [Win2D 中的游戏循环：CanvasAnimatedControl](https://www.cnblogs.com/walterlv/p/10236395.html)
|
||
- [r2d2rigo/Win2D-Samples](https://github.com/r2d2rigo/Win2D-Samples/blob/master/IrisBlurWin2D/IrisBlurWin2D/MainPage.xaml.cs)
|
||
- [CommunityToolkit - 从入门到精通](https://mvvm.coldwind.top/)
|
||
|
||
## 💡 灵感来源
|
||
|
||
部分设计思路参考自下述插件/软件（不含间接或直接引用、修改的代码，仅作为设计思路指导方向）。
|
||
|
||
- [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)
|
||
|
||
## ⭐ 星标记录
|
||
|
||
<div style="display: flex; justify-content: space-around; align-items: flex-start;">
|
||
<img src="https://api.star-history.com/svg?repos=jayfunc/BetterLyrics&type=Date)](https://www.star-history.com/#jayfunc/BetterLyrics&Date" width="100%" >
|
||
</div>
|
||
|
||
## 🤗 欢迎反馈问题、提交代码
|
||
|
||
如果发现 Bug 请在 Issues 内提出，同时也欢迎任何想法、建议。
|
||
|
||
## ⚠️ 免责声明
|
||
|
||
本项目按“原样”提供，不提供任何形式的担保。
|
||
所有歌词、字体、图标及其他第三方资源均为其各自版权所有者的财产。
|
||
本项目作者不主张对这些资源的所有权。
|
||
本项目为非商业用途，不得用于侵犯任何权利。
|
||
用户有责任确保其使用符合适用的法律和许可协议。
|
||
|
||
## 💭 社交媒体分享
|
||
|
||
|
||
|
||
|