chthollyphile/folia-major

Folia 是一个围绕全屏动态歌词舞台构建的在线与本地音乐播放器，适合重视歌词呈现效果、愿意把它当作视觉展示型应用的听众。官方提供 Windows / macOS / Linux 的 Electron 桌面版，以及基于 Node.js 的 Web 版，Web 版可部署后以 PWA 方式在手机上使用。

功能与使用方式

搜索歌曲、歌手或专辑后即可播放，并自动加载封面与歌词。也可以导入本地音频文件；README 说明索引保存在本地，不会上传文件内容。本地歌曲可自动匹配在线歌词与封面，匹配不准时可手动修正。同目录下的同名 .lrc、.vtt、.ttml、.qrc、.yrc、.krc 歌词文件以及内嵌 LRC 会被自动识别，并适配 LDDC 生成的增强型逐字歌词。通过单独的本机 Now Playing 服务，还能把外部播放器的歌曲、时间轴和歌词接入 Folia，驱动舞台视图与全屏歌词。

音源包括网易云、酷狗、QQ 音乐、Navidrome 和本地曲库，桌面端另有波点、YouTube Music、Spotify 与汽水音乐。多种全屏歌词主题各有排版氛围和可调参数，并能自动适配不同窗口尺寸。

视觉效果的来源

有两套机制支撑体验。AI 主题生成依据歌曲情绪和歌词内容生成背景与视觉参数，使主题与具体歌曲对应，而不是固定预设。桌面端的 Folium 模组系统（实验性）可添加歌词动画模式、背景类型、播放页叠加图层、进度条按钮与标记、命令等；模组以可信代码运行，启用前需在原生窗口确认，文件变化后需重新确认。模组市场对已签名模组显示「官方认证」，通过安全审查但未签名的显示「先行测试」，无签名的第三方模组显示「未验证」但仍可使用。模组系统默认关闭，仅桌面版可用。

部署要求与限制

• **桌面端：**从 Releases 下载安装包；Linux 还可通过 AUR 或社区第三方 Flatpak 获取。
• **Web 端：**自行部署需要 Node.js 24 或更高版本，也可一键部署到 Vercel 或 Cloudflare。自托管时访问本地音乐目录依赖可信 HTTPS 安全上下文，部署文档包含 NAS 反向代理和证书要求。
• **Vercel / Cloudflare 上的 QQ 音乐：**需要把 VITE_QQ_API_BASE 设为 /api/qq，并配置服务端 QQ_SESSION_SECRET；播放前必须先登录，支持微信扫码和手机 QQ 扫码，手机 QQ 扫码要求 qq-music-api 3.3.3 或更高版本。
• **移动端：**推荐在部署好的 Web 版上以 PWA 方式安装；两个 Android 移植版均为第三方社区项目，功能与官方 PC 版存在差异。
• **可选同步：**外观设置与 AI 主题库可通过自行托管的 sync-server 跨设备同步，支持 Cloudflare Workers/D1、Docker 或 Node.js + SQLite 三种部署方式，配置服务端地址和 SYNC_TOKEN 后启用。

许可证

代码采用 AGPL-3.0。README 声明仓库及源码仅供个人学习、技术交流与非营利测试，并说明项目在 AI 广泛协助下开发，仍可能存在不易察觉的问题。在线音乐、歌词与封面版权归各自权利人，README 将传播、加工或再分发在线资源引发的责任归于使用者。

项目源码与说明