📌 项目地址：chthollyphile/folia-major | ⭐ 960 颗星 | 🔧 TypeScript | 📜 未标注
为什么需要 Folia？——当歌词不只是文字
大多数音乐播放器的歌词界面要么是静态文本滚动，要么是简单的卡拉OK染色。如果你希望歌词像PV（Promotion Video）一样随着音乐流动，自动匹配情绪色彩和动态特效，Folia 是当前唯一专注于这一痛点的开源项目。它不只播放音乐，更将歌词渲染为沉浸式的视觉主体，支持网易云、Navidrome 以及本地音乐库作为音源。
快速上手：桌面端即装即用 vs Web 端一键部署
桌面端
- 前往 Releases 页面 下载对应系统的安装包（Windows / macOS / Linux）。
- 安装后打开，Folia 内置前后端运行环境，无需额外配置即可搜索、播放网易云音乐，或导入本地音频文件。
Web 端（适合移动设备或多端同步）
- 点击 Vercel 一键部署，克隆项目到你的 GitHub 账号。
- 部署完成后即可在浏览器访问，支持手机、平板等设备。
- 你也可以参考官方 部署指南 修改环境变量（如自定义 Navidrome 服务器地址）。
核心亮点：歌词动画、智能匹配、AI 主题
1. 多套歌词动画主题
Folia 内置六种以上具有不同排版氛围的动画主题，例如「浮名」「流光」「心象」「云阶」「群唱」「倾诉」。每个主题都可调节参数（速度、模糊度、粒子密度等），实现类似“文字PV”的视觉效果。动画会根据窗口尺寸自动响应式适配，不需要手动调整分辨率。
2. 智能歌词匹配流程
对于本地音频文件，Folia 按以下优先级自动补全歌词与封面：
– 音频文件的 ID3 元数据
– 同目录下同名 .lrc 歌词文件（支持 LDDC 增强型逐字歌词）
– 在线匹配（通过歌曲名和艺术家自动搜索）
如果自动匹配不准确，你可以在播放界面右侧面板进入“本地”选项卡，手动搜索并指定更合适的歌词、封面或元数据来源。也可以完全关闭在线匹配，仅使用本地信息。
3. AI 生成配色与背景
基于歌曲情绪和歌词内容，Folia 调用 AI 模型生成动态渐变背景和视觉参数，使每一首歌都拥有独一无二的沉浸式氛围。该功能在桌面端和 Web 端均可使用。
4. 多源播放控制
- 网易云音乐：直接搜索歌曲、歌手或专辑播放。
- Navidrome：在设置中添加服务器地址后，自动同步你的私有音乐库。
- 本地文件：导入后保存在本地索引，不上传文件内容。
- Now Playing 接入：通过 now-playing-service 协议，可以将其他播放器（如 MPC、foobar2000）的当前歌曲、时间轴和歌词信息转发给 Folia，驱动其舞台视图和全屏歌词渲染。
与同类工具的区别
| 特性 | Folia | 网易云 / QQ音乐 官方客户端 | 纯本地播放器（如 MusicBee） |
|---|---|---|---|
| 歌词动画沉浸感 | 全屏多主题、动态特效、AI配色 | 仅简单滚动/卡拉OK | 一般无动画或极简 |
| 多音源支持 | 网易云 + Navidrome + 本地 + NowPlaying | 仅自家曲库 | 仅本地 + 可安装插件 |
| 部署自由度 | 桌面原生 / Vercel Web / 自托管 | 只能使用官方客户端 | 桌面端单一 |
| 智能匹配 | 自动 + 手动修正 | 内置匹配 | 需手动编辑标签 |
Folia 并不追求成为全功能播放器，它的核心价值在于“歌词观赏体验”，特别适合希望通过歌词获得视觉享受的用户、Vocaloid 听众、以及希望用私人音乐库搭配动态歌词的用户。
注意事项与局限性
- AI 辅助开发：项目声明“在 AI 的广泛协助下开发，可能仍存在细微或不易察觉的问题”，实际使用中可能遇到歌词时间轴轻微偏移、动画在某些显示器缩放比例下表现不一致等情况。
- 网易云支持：依赖于网易云公开的搜索和播放接口，若接口变动或地区限制可能导致无法使用。
- 本地匹配：对于音质较低的音频文件（如 128kbps），在线歌词匹配成功率可能下降，建议优先使用内嵌或同目录 LRC 文件。
- Vercel Web 版：需要 Node.js 运行环境，且歌词动画性能受浏览器限制，移动端建议使用桌面端或配置较高的设备。
- 开源许可证：具体许可类型请参见仓库根目录的 LICENSE 文件，使用前请查阅是否符合你的应用场景。
如果以上特点符合你的期望，可以直接从 Releases 页面 下载桌面版体验，或一键部署到 Vercel 测试 Web 版本。