平时听歌总嫌自带播放器歌词干巴巴？黑白文字一行行滚动，毫无氛围感，刷到好看的歌却没有匹配的动态效果，想截一张氛围感歌词图都难。试过不少第三方客户端，要么界面臃肿卡顿，要么歌词渲染生硬，要么不支持本地无损曲库，自建 Navidrome 音乐库还找不到适配前端，折腾半天体验依旧拉胯。
软件格律诗 给大家分享这款专门做绚丽歌词动画的开源播放器 Folia 不管是在线网易云曲库，还是电脑、NAS 里存的本地无损音乐，甚至自建 Navidrome 私人音乐服务器，都能完美对接，歌词动画细腻到超出预期，整套界面干净清爽，没有多余广告和繁杂功能，只专注听歌与可视化歌词，对颜值党、本地音乐收藏者、自建音乐库玩家太友好。
市面上播放器普遍痛点，Folia 能为你解决什么
1. 绝大多数客户端歌词仅简单滚动，无动态渲染、渐变、光影动画，氛围感缺失；
2. 在线播放器无法读取本地 FLAC、WAV 无损音乐，本地播放器不支持网易云曲库；
3. 自建 Navidrome 私人音乐服务器缺少高颜值前端，原生界面简陋，歌词展示简陋；
4. 想要 AI 生成歌曲主题背景、氛围感画面，需要额外搭配工具，操作繁琐；
5. 部署流程复杂，环境变量配置杂乱，新手本地开发、云端部署容易报错；
6. 界面堆砌大量功能按钮，杂乱拥挤，想沉浸式看歌词动画时干扰太多。
Folia 从底层针对这些问题优化，核心定位很清晰：以绚丽歌词动画为核心的全兼容开源 Web 音乐播放器，兼顾在线曲库、本地音乐、自建 Navidrome 服务，轻量化无冗余，动画渲染流畅不占用大量内存，不管浏览器打开还是本地部署都稳定。
主要功能特点
行业顶尖级绚丽动态歌词动画，专属可视化渲染引擎
这是 Folia 最核心的卖点，也是区别所有同类播放器的关键。项目内置独立歌词加载逻辑，异步解析歌曲副歌、逐句时间轴，自动匹配渐变、上浮、辉光、淡入淡出多层动画效果，不会出现歌词跳帧、不同步问题。
普通播放器只是文字上下滚动，Folia 会根据歌曲节奏调整文字流动速度，高潮段落文字放大提亮，舒缓段落柔和渐变虚化，双语歌词分层渲染，翻译小字弱光衬托主歌词，不用额外调整参数，打开歌曲自动适配动画风格。
平时喜欢循环单曲、截取歌词氛围感截图的朋友，不用再后期修图，播放界面原生自带柔和模糊背景、专辑封面虚化滤镜，随手截图都能直接当壁纸。
三端曲库兼容：网易云 API、本地音乐、Navidrome 自建服务器
市面上播放器大多二选一，要么只做在线，要么只做本地，Folia 三者打通，一套前端搞定所有音乐资源。
- 网易云曲库对接：依赖 NeteaseCloudMusicEnhanced 后端 API，自行部署 API 服务填入地址即可，完整同步歌单、收藏、排行榜、歌手专辑，搜索速度稳定；
- 本地音乐视图：内置 local-music 页面，读取本地音频文件元数据，自动匹配本地 LRC 歌词，支持 MP3、FLAC、WAV 全格式无损，无需上传云端，本地离线也能播放；
- Navidrome 完美适配：兼容 Subsonic 标准接口，填入自建 Navidrome 服务地址，直接读取 NAS、服务器存储的私人无损曲库，海量本地歌曲流畅加载，解决 Navidrome 原生界面简陋、无精美歌词动画的短板。
Google Gemini AI 赋能，一键生成歌曲专属视觉主题
自带 AI 视觉生成模块，填入自己的 Gemini API Key 就能启用。根据歌曲曲风、歌词内容、歌手风格自动生成匹配背景画面、界面配色主题。
听抒情慢歌自动生成低饱和温柔滤镜，电子、摇滚曲目切换高对比光影动态背景，不用手动调色，AI 自动适配整套界面色调，彻底告别千篇一律的黑白默认界面。不想启用 AI 功能也可以不填写密钥，基础播放、歌词动画不受任何影响，功能完全隔离，不强制依赖第三方接口。
支持歌词缓存机制，同一首歌二次打开无需重新解析，动画加载速度更快；页面无冗余弹窗、开屏广告、付费弹窗，完全开源免费，MIT 开源协议，个人使用无任何限制，商用仅需申请对应授权。
极简干净 UI，PWA 网页应用，浏览器等同于客户端
整体采用现代化极简 Web 设计，无繁杂侧边栏、冗余功能入口，核心区域留给歌词动画与专辑封面，操作逻辑简单，新手打开就能上手。支持 PWA 特性，浏览器添加到桌面，打开和本地软件一样，不用每次输入网址，手机、电脑浏览器都能流畅运行，跨设备同步播放进度。
标点、排版严格克制，没有堆砌宣传文案，纯白描式界面设计，不抢歌词动画的视觉重心，长时间听歌、看动态歌词不会视觉疲劳。
部署简要步骤（精简版，详细看官方指南）
1. Window 桌面版，直接安装即可;
2. 本地部署 拉取仓库代码 → npm install 安装依赖 → cp .env.example .env.local → 填写网易云 API 地址、Gemini 密钥（可选） → vercel dev 启动本地服务，浏览器访问对应端口即可使用。
3. Vercel 云端部署 打开官网部署按钮，关联 GitHub 仓库，后台配置两项环境变量，自动构建上线，外网随时随地访问个人音乐播放器。
免责声明
本项目在 AI 的广泛协助下开发，因此仍可能存在细微或不易察觉的问题。若给你带来不便，敬请理解。本项目主要用于展示播放动效、界面设计与相关工程实现。应用中涉及的在线音乐流媒体、歌词、专辑封面及其他内容，其版权均归对应权利人所有。
本仓库及其源代码仅供个人学习、技术交流与非营利测试使用。请勿将其用于商业盈利用途。若因对在线资源的传播、加工或再分发而引发版权纠纷或其他责任，均由使用者自行承担，项目开发者不承担相关责任。请始终尊重数字版权，并在条件允许时通过官方平台支持正版音乐。
如果你收藏大量本地无损音乐、自建 Navidrome 私人音乐服务器，或是经常使用网易云听歌，又看重动态歌词、界面氛围感，Folia 绝对是目前最优开源选择。市面上很难找到一款同时兼容三类曲库、把歌词动画作为核心亮点的轻量化 Web 播放器，完全开源免费无广告，部署简单，二次修改自由度高，颜值与实用性同时拉满。
不管是办公间隙当背景音乐播放器，还是深夜沉浸式听歌、截取氛围感歌词画面，Folia 都能完美适配需求，不用再在多款软件之间来回切换，一套前端搞定全部音乐资源。
更新日志
v0.5.18
- 新功能：设置中允许在播放的时候自动执行AI主题生成，会在播放到未生成过主题的歌曲的时候立刻执行一次AI主题生成。注意这会导致较高的token消费，请谨慎使用，确认您能接受连续主题生成的token费用之后再开启！
- 修复navidrome集成中一个导致封面反复刷新的问题
- 修复错误的主题，颜色配置可能导致应用崩溃的问题，现在会对错误的主题配置进行自动修复
官方网站
官方网站
仓库地址
https://github.com/chthollyphile/folia-major
使用文档
https://folia-site.vercel.app/guide
