如果你和我一样，听音乐时喜欢盯着歌词看，甚至会因为某个播放器的歌词效果太丑而弃坑——那你得试试 Folia。
这个开源项目（GitHub，AGPL-3.0 协议）的核心卖点很简单：把歌词播放做成全屏沉浸式动画，像文字PV一样。它支持网易云、Navidrome 和本地音乐库，还能用 AI 根据歌曲情绪生成配色主题。2026 年 7 月还在频繁更新（最新提交 7 月 7 日），目前已有 21 位贡献者。
为什么需要 Folia？
说真的，大部分音乐播放器的歌词功能都挺敷衍的：要么是一行行往上滚的白字，要么是居中显示但毫无设计感。网易云自带的歌词效果其实还不错，但它不支持自托管的 Navidrome——而很多 NAS 玩家恰恰是用 Navidrome 管理本地音乐库的。
Folia 的出现填补了这个空白：
- 专为歌词动画设计：不是顺便加个歌词功能，而是把歌词动画作为核心体验。
- 多音源支持：网易云、Navidrome、本地音乐，一个播放器搞定。
- AI 增强：根据歌曲情绪生成沉浸式背景和视觉参数，不用自己调色。
- 开源可自建：Web 版可以部署到 Vercel 或 Cloudflare Workers，桌面端有 Windows/macOS/Linux 三平台打包。
核心功能速览
1. 全屏歌词动画（这才是重点）
Folia 提供了多种歌词动画主题，每种都有不同的排版氛围和可调参数。官方文档里提到了这几个：
- 浮名 (Fume)：
- 流光 (Lumi)：
- 心象 (Cad)：
- 云阶 (Pat)
- 群唱 (Cappella)
- 倾诉 (Tilt)
最近的提交记录里还能看到新增了 VisualizerCladdagh，带星空背景、发光进度指示、逐字旋转和呼吸动画。简单说，这些动画让歌词不再是”显示”，而是”演出”。
2. 多音源支持
网易云集成：
- 搜索、播放、获取歌词和封面，全部走网易云 API（接入的是 NeteaseCloudMusicApiEnhanced 项目）。
- 可以在线强制指定歌词来源（有时候自动匹配的歌词不对，可以手动改）。
Navidrome 集成：
- 直接把 Navidrome 当作音乐源，播放你存在 NAS 上的音乐。
- 支持 Navidrome 统计信息（最近播放、最常播放等）。
- 对于 NAS 玩家来说，这意味着你可以用 Folia 作为 Navidrome 的前端，获得比 Navidrome 原生 UI 更炫的歌词体验。
本地音乐支持：
- 导入本地音频文件，索引信息只存在本地，不会上传文件内容。
- 自动匹配在线歌词和封面，也支持手动修正。
3. 智能歌词匹配
Folia 的歌词匹配优先级是：
- 音频文件自身元数据
- 同目录同名的歌词文件（支持
.lrc、.vtt、.ttml、.qrc、.yrc、.krc格式） - 内嵌 LRC 歌词
- 在线匹配结果
它还适配了 LDDC 生成的增强型逐字歌词格式，并且接入了 AMLL TTML 歌词库（高质量逐词歌词）。
4. AI 主题生成
这个功能挺有意思：Folia 会根据歌曲情绪和歌词内容，自动生成沉浸式背景和视觉参数。具体是怎么实现的，文档里没细说，但从提交记录看，用的是 Gemini（项目里有 .gemini 目录）。效果相当于每首歌都有独特的视觉主题，不用自己调色。
5. Now Playing 接入
支持通过本机 Now Playing 服务接入外部播放器的歌曲、时间轴和歌词信息。这个设计很实用——如果你用其他播放器（比如 Navidrome 自带的 Web UI）控制播放，Folia 可以同步显示歌词。
安装部署（三种方式）
方式一：桌面端下载（最省心）
适合不想折腾部署的用户。
- 前往 Releases 页面 下载对应平台的安装包。
- Windows、macOS、Linux 都支持。
- 桌面版内置前后端运行环境，开箱即用。
方式二：Vercel 一键部署（Web 版）
适合想在浏览器里用，或者想在移动设备上访问的用户。
- 点击这个 一键部署链接。
- 按提示完成 Vercel 部署（需要 GitHub 账号和 Vercel 账号）。
- 详细步骤见 Vercel 部署指南。
方式三：自行部署
适合想在 NAS 或 VPS 上跑服务端的用户。
- 克隆仓库：
git clone https://github.com/chthollyphile/folia-major.git - 安装依赖：
npm install - 配置环境变量（参考
.env.example） - 运行：
npm run dev（开发模式）或npm run build && npm run start（生产模式）
具体环境变量和配置说明见 技术与开发说明。
使用技巧
1. 接入 Navidrome
在 Folia 的设置里填入你的 Navidrome 地址、用户名和密码，就能直接播放 Navidrome 里的音乐了。实测加载速度取决于 Navidrome 服务器的性能和你家里的网络环境。
2. 本地音乐匹配优化
如果你的本地音乐文件命名规范、元数据完整，Folia 的自动匹配会很准。如果不准，可以在播放界面右侧面板进入”本地”选项卡，手动搜索并指定歌词、封面或元数据来源。
3. 歌词文件最佳实践
把歌词文件放在和音频文件相同的目录里，文件名和音频文件同名（扩展名换成 .lrc 或其他支持的格式）。Folia 会自动加载，不需要额外配置。
4. 动画效果微调
每种歌词动画主题都有可调参数（比如颜色、速度、粒子效果等）。在设置里可以找到这些选项，根据自己的喜好调整。
有什么坑？
- 版权声明比较严格：项目明确说了，在线音乐流媒体、歌词、封面等版权归对应权利人所有，因对在线资源传播、加工或再分发引发的版权纠纷由使用者自行承担。所以如果你打算公网部署，最好只给自己用，别开放注册。
- AI 功能可能需要 API Key：AI 主题生成功能需要 Gemini API Key（从提交记录和
.gemini目录推测）。如果你不想配置，可以只用基础功能。 - Navidrome 集成可能不够稳定：从提交记录看，Navidrome 统计信息支持是 2026 年 6 月 20 日才加的功能，可能还有 Bug。遇到问题可以去 Issues 反馈。
- 桌面端打包可能有问题：Linux 包、Wayland/Hyprland 遥控窗等细节在文档里被特别提及，说明可能存在一些平台相关的坑。
- 项目还比较新：虽然已有 837 次提交和 21 位贡献者，但相比于成熟项目，Folia 的功能和文档可能还不够完善。做好遇到 Bug 的心理准备。
总结
Folia 是一个很有想法的开源项目：它把”歌词播放”这件事从”功能”提升到了”体验”。如果你在乎听音乐时的视觉感受，或者你需要一个支持 Navidrome 的好看播放器，Folia 值得一试。
部署门槛不高（Vercel 一键部署真的很香），桌面端也开箱即用。坑有一些，但都在可接受范围内。毕竟，能看到这么用心的歌词动画，折腾一下也值了。
相关链接：
封面图来自 Folia GitHub 仓库，侵权删除。