Folia——把歌词做成主角的开源音乐播放器，4300+ Star，歌词动效堪比文字 PV

听歌这件事，我们大概都经历过三个阶段：最早是本地播放器比谁的音效插件多，后来是各家音乐 App 比谁的曲库全，再到现在——你会发现真正让人愿意为一款播放器折腾的，往往不是音质参数，而是看着舒服。

今天五哥要给大家介绍的 Folia，就是把「看着舒服」这件事做到极致的那一个。它的官方副标题只有四个字，却把野心说得很清楚：

Lyrics Reimagined // 辞曲新境

一句话概括：一款把全屏歌词动画当主角的开源音乐播放器。网易云、酷狗、Navidrome、本地音乐库全都吃得下，配上 AI 生成的配色主题和多种全屏歌词动效，听歌的时候屏幕上呈现的效果，接近一支文字 PV。

📌 Folia 是什么？

Folia 出自 GitHub 用户 chthollyphile 之手，仓库名为 folia-major。项目从 2025 年 11 月底建仓，到现在已经拿下 4300+ Star、330+ Fork，35 位贡献者参与，最新版本仍在高频迭代——在这两年"开源播放器"这个拥挤赛道里能冲上 GitHub TypeScript 热榜，本身就说明了一些问题。

它提供两种形态：

• 桌面端：基于 Electron 打包，Windows / macOS / Linux 三平台都有安装包，前后端运行环境内置，即装即用；
• Web 端：基于 Node.js（要求 ≥ 24），支持 Vercel / Cloudflare 一键部署，也能用 Docker Compose 全栈自托管，移动端还可以装成 PWA。

项目语言是 TypeScript，协议为 AGPL-3.0。

划四个重点：

• 🎬 歌词是主角——浮名、流光、心象、云阶、群唱、倾诉、镜台、时计，八套内置全屏主题各有各的排版氛围和可调参数；
• 🎵 多源聚合——网易云、酷狗、QQ 音乐、Navidrome 私有云、本地音乐库，一个前端全接住；
• 🧠 AI 生成主题——根据歌曲情绪和歌词内容，自动生成沉浸式背景与视觉参数；
• 🆓 开源免费——AGPL-3.0，无广告无账号（QQ 源除外，需登录），代码可自持。

✨ 核心能力：不止是"能播放"

很多开源播放器的通病是功能能跑但视觉敷衍，Folia 恰好反过来——它把大量精力投在了渲染和动效上，同时在"基本功"上也没偷懒。

歌词这块，格式覆盖得相当狠。除了常规的在线匹配，它会自动加载音频同目录下的同名歌词文件，支持的格式包括 .lrc（含内嵌 LRC）、.vtt、.ttml、.qrc、.yrc、.krc。

更进一步，它还适配了 LDDC 生成的增强型逐字歌词格式，并接入了 AMLL 的 TTML 逐词歌词库。逐字歌词意味着每个字都能随旋律单独缩放、打光、过渡——这正是"文字 PV"观感的来源。

本地音乐库的体验是认真做过的。导入本地音频文件后，索引信息只保存在本地，不上传文件内容。原始元数据、同目录歌词和封面会被读取，信息不全时再通过网易云、QQ、酷狗依次补全（自动匹配按这个顺序回退）。匹配不准怎么办？可以手动挑候选、恢复首次导入的信息，甚至进一步合并或拆分艺术家与专辑实体——用过本地曲库的人都知道，这套补全逻辑有多刚需。

还有个冷门但好用的功能：Now Playing 接入。通过本机的 now-playing-service，Folia 能接管外部播放器的歌曲、时间轴和歌词信息，直接驱动自己的舞台视图与全屏歌词渲染。也就是说，你完全可以用别的播放器放歌，让 Folia 当那块"歌词舞台屏"。

其他值得一提的：

• 🔍 在线搜索歌曲 / 歌手 / 专辑，播放时自动加载封面与歌词；
• 🖥️ 桌面端内置 ffmpeg，可处理 ALAC 等格式转码；
• 📊 WebGL / WebGL2 可视化渲染，内置 onnxruntime-node 分析 worker。

🧩 模组系统 Folium：把动效交给社区

这是 Folia 里最有想象力的部分，但也要先说清楚前提：

⚠️ 实验性功能，仅桌面版可用，默认关闭。需要在「设置 → 实验室 → 模组系统」里手动开启。

开启之后，模组能做的事情包括：

• 添加新的歌词动画模式和背景类型；
• 在播放页上叠加自定义内容；
• 给进度条加按钮和标记；
• 注册命令与设置分区；
• 在歌词显示前改写歌词；
• 通过 Node 入口调用 ffmpeg 等本地能力。

安装方式很直白：去模组市场下载 zip，拖进模组面板即可。市场里的模组都带 Folium 签名，装好后显示「官方认证」；没有签名的第三方模组则显示「未验证」，同样能用。

安全上有明确设计：模组以可信代码运行，每个模组在启用前都要在原生窗口里确认一次，文件发生变化后需要重新确认。换句话说，它把"你确定要信任这段代码吗"这个问题交还给了用户。

🚀 上手：装还是部署，随你

桌面版——最省事的路子。去 Releases 页面下载对应平台的安装包即可：

📌 国内网络下载慢的话，可以用夸克网盘或百度云，但网盘只提供 Windows 与 Apple Silicon 的正式版。

macOS 如果提示"应用已损坏"，别慌——这通常是包未签名/未公证被 Gatekeeper 拦下，不是安装包本身坏了，按官方说明放行即可。

Web 端——想手机、想浏览器体验就走这条：

• Vercel：点一键部署按钮直接建项目；
• Cloudflare：同样支持一键部署；
• Docker Compose：自托管用户的全栈方案。

有个细节值得记一下：在 Vercel / Cloudflare 上跑 QQ 音乐源，不再需要额外部署一个常驻 API 实例，只要把 VITE_QQ_API_BASE 填成 /api/qq，再配一个服务端密钥 QQ_SESSION_SECRET（注意不要加 VITE_ 前缀）就行。这种形态默认只支持微信扫码登录，且播放前必须先登录。

另外，本地音乐目录访问依赖可信 HTTPS 上下文——NAS 用户记得给反向代理配上有效证书，否则浏览器不给读本地目录。

移动端——官方推荐的姿势是：部署好 Web 版本后，用 Chrome for Android / iOS Safari「添加到主屏幕」，把它当 PWA 用。有技术能力的，还可以参考官方示范仓库 folia-sonnet，用 Capacitor 把 Web 版打成安卓 APK。

🔁 Sync Server：跨设备同步

如果你在多台设备上用 Folia，可能希望配色主题和外观设置能同步。官方提供了一个可选的同步服务端 sync-server，用途很明确——在多设备间同步外观设置与 AI 主题库，由用户自行托管。

三种部署方式：

• Cloudflare Workers / D1：免运维的 Serverless 方案，官方推荐；
• Docker：镜像与 Compose 入口都在部署目录里；
• Node.js 自托管：基于 SQLite，适合本地或不想用 Docker 的环境。

部署完成后，在 Folia 的「存储设置」里填上服务端地址和 SYNC_TOKEN 就启用了。

🆚 和主流播放器比，它赢在哪

它的定位其实很清晰：不是要取代你的音乐 App，而是取代那块"歌词屏"。副屏摆一块 Folia，或者 NAS 上自建一套，视觉效果是商用客户端给不了的。

🤔 该说的坑，也得说

• ⚠️ 版权是硬边界——项目直接接入第三方在线音源，涉及的流媒体、歌词、封面版权均归权利人所有。仓库明确写了：源码仅供个人学习、技术交流与非营利测试使用，禁止商业盈利，因传播、加工、再分发引发的版权纠纷由使用者自行承担。想拿来做商业产品，请先想清楚。
• ⚠️ AGPL-3.0 是有传染性的——如果你基于它改出一个对外的网络服务，修改部分同样需要开源。闭源商业产品想建在它上面，先读完许可证。
• ⚠️ 项目由 AI 广泛协助开发——README 自己承认"仍可能存在细微或不易察觉的问题"。当主力工具前，建议留个心理预期。
• ⚠️ 实验性功能有门槛——模组系统默认关闭、仅桌面版可用；本地音乐访问要 HTTPS；QQ 源要单独配密钥和登录。这些都不是"下载打开就能用"的顺滑体验。

🎯 总结

Folia 让我觉得有意思的地方在于：它没有去卷哪个老赛道（音质、曲库、无损），而是把"歌词"这个所有人都默认是附属品的东西，拎出来做成了主角。多音源聚合、本地曲库管理、AI 主题、模组扩展、可自托管同步——这些能力单拎一个出来都不算新奇，但组合在一起，就成了一套完整的"桌面音画组件"方案。

如果你符合下面任意一条，都值得试一下：

• 🎧 听歌时习惯盯着歌词看，甚至想截图做壁纸的人；
• 🖥️ 有一块副屏，想摆点会动又好看的东西；
• 🏠 自建了 Navidrome、收藏了一堆本地无损，缺个拿得出手的前端；
• 🛠️ 对歌词动效、React 性能优化、Electron 打包这些实现感兴趣，想读源码的人。

也许最动人的一句评价不是"功能真全"，而是——原来歌词可以这样被对待。

🔗 官网：folia-site.cielaniska.top
🔗 GitHub：github.com/chthollyphile/folia-major
🔗 使用指南：folia-site.cielaniska.top/guide
🔗 模组市场：folium-compound.vercel.app

歌词从伴奏的注脚变成舞台中央的主角，Folia 把这件事做成了开源。

— 墨涩