Folia 全屏歌词播放器完整指南：15 种歌词动画与多音源播放配置教程
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
Folia 是一个以全屏歌词动画为核心的开源音乐播放器，歌词不是角落里的滚动字幕，而是占据整块屏幕的主角。它支持网易云、酷狗、QQ 音乐、Navidrome（自建音乐服务器）在线音源与本地文件夹曲库，桌面端与 Web 端通用，对任意歌曲按一次 H，界面即退场，只剩按节奏呼吸的歌词动画。
Folia 支持哪些音乐源？
Folia 的音源分两类，覆盖在线与本地场景：
- Web 版在线音源：网易云音乐、酷狗、QQ 音乐、Navidrome。在首页搜索框输入歌名、歌手或专辑即可搜索并播放，封面与歌词自动加载。
- 桌面端额外音源：波点音乐、YouTube Music、Spotify、汽水音乐。
- 本地音乐库：导入文件夹后直接播放，索引保存在本机，不上传音频内容。
- 外部播放器接入：通过本机 Now Playing 服务（一个把系统媒体信息广播出去的轻量服务）接入其他播放器的歌曲、时间轴与歌词，用 Folia 只渲染舞台视图与全屏歌词。
在线匹配与歌词补全按网易云 → QQ 音乐 → 酷狗顺序回退，某个来源没有候选时自动换下一个。
我该下载哪个版本？桌面端安装步骤
桌面版基于 Electron（用 Web 技术打包桌面应用的框架），内置前后端运行环境，装完即用：
| 平台 | 获取方式 |
|---|---|
| Windows / macOS | Releases 页面的安装包，Apple Silicon 有专属版本 |
| Debian / Ubuntu / Linux Mint | .deb包 |
| Fedora / RHEL / openSUSE | .rpm包 |
| Arch / Manjaro | AUR 安装folia-major-bin |
| 其他 Linux 发行版 | 解压tar.gz直接运行folia-major |
| 手机 / 平板 | 部署 Web 版后以 PWA 形式添加到主屏幕 |
不想装桌面端、只在浏览器里用的话，走后文的 Web 部署。
如何播放第一首歌？
首次启动会有一页欢迎引导，扫一眼即可。日常操作其实只有两步：
- 在首页搜索框输入歌名、歌手或专辑名，点击搜索结果即开始播放，封面和歌词自动加载；
- 点播放区的
+把歌加入队列。
一个省掉鼠标的小技巧：在任何歌曲列表里直接敲键盘，就能即时过滤当前内容，不必先点进搜索框。
如何让歌词接管整个屏幕？全屏歌词快捷键一览
这是 Folia 的主场。播放歌曲后按H，播放控件全部隐藏，屏幕只剩歌词动画；再按一次恢复。配合F11铺满窗口，所有动画都是响应式布局，自动适配尺寸，无需额外设置。
| 快捷键 | 功能 |
|---|---|
Space | 播放 / 暂停 |
←/→ | 快退 / 快进 5 秒 |
Ctrl + →/Ctrl + ←（macOS 为Cmd） | 下一首 / 上一首 |
S | 打开命令面板（万能入口） |
Ctrl + P | 打开播放队列 |
P | 展开 / 收起右侧面板（切换在线 / 内嵌 / 本地歌词） |
Tab | 切换右侧面板选项卡 |
H | 隐藏播放器控件，只剩歌词 |
F11 | 全屏 |
换风格不用翻文档：设置 → 视觉 里挑主题，每个主题下面都有独立调参面板（动画节奏、字幕、背景分开控制）。拿不准就去「主题公园」逛一圈——所有主题的真实动画都会跑起来，一边听一边对比。
内置歌词动画有哪些？主题清单
内建歌词动画共 15 种（代码中的模式清单为唯一权威），风格差异很大：
- 浮名 / 流光：逐字流光的经典形态，歌词像光一样从暗场浮出
- 群唱：歌词以群聊对话呈现，带头像和表情，适合合唱与说唱
- 镜台：3D 场景，歌词悬浮在立体空间中
- 时计：时钟机械风，齿轮与摆锤驱动
- 绘光：舞台光式演出，体积光束、烟雾与浮尘
- 花火：日式歌词 PV，色块字配烟花
- 倾诉、心象、云阶、凝彩、商籁：从拼贴排版到舞台光束各不相同，其余还有经典、静止等模式
动画与背景层可以分开搭配，每个主题都能单独调参，参数会随设置一起导出、同步。
本地音乐库有哪些能力？导入与歌词匹配
进首页本地音乐区域，点导入文件夹选定目录，等待后台扫描，专辑封面与内嵌歌词会一并读出。几个关键细节：
- 支持 MP3、FLAC、M4A、WAV、OGG、Opus、AAC；不支持 CUE 分轨，整轨文件按一首歌导入
- 同目录同名
.lrc、.vtt、.ttml、.qrc、.yrc、.krc歌词文件自动识别，兼容 LDDC 的增强型逐字歌词 - 目录下的
.foliaignore按.gitignore语法排除文件；cover.png/cover.jpg/cover.jpeg可作为整夹封面，优先于内嵌封面 - 缺失的歌词与封面可通过在线源批量自动匹配，匹配不准可手动选候选、恢复本地信息，或合并、拆分艺术家与专辑实体
- 支持导入
.m3u/.m3u8歌单，Folia 歌单可导出为.m3u8；删除曲库只改本地索引，不动磁盘文件
重扫规则、实体整理、权限恢复与故障排查的完整说明见 本地音乐库管理文档。
如何部署到自己的服务器？Web 部署与源码构建
一键部署：Vercel 与 Cloudflare 均支持一键部署 Web 版。部署后 QQ 音乐无需再单独部署 API 实例：把VITE_QQ_API_BASE填成/api/qq，服务端密钥QQ_SESSION_SECRET（不加VITE_前缀）配好即可走扫码登录，播放前需先登录。
Docker 全栈自托管：仓库deploy/docker/提供完整 Web 堆栈（网关 + Folia API + 网易云/酷狗/QQ 接口 + Sync Server），要求 Docker Engine 24+ 与 Compose v2，对外只暴露 Web（默认 18080）与 Sync Server（默认 13000）两个端口，详见 Docker Compose 全栈部署配置：
docker compose up -d --wait从源码运行：需要 Node.js ≥ 24，装依赖后启动开发服务器：
git clone https://gitcode.com/GitHub_Trending/fo/folia-major && cd folia-major npm install npm run dev环境变量、Stage API 与桌面端细节见仓库docs/technical.md。
进阶玩法：AI 主题、模组系统与多设备同步
AI 主题生成：接入 Google Gemini 或 DeepSeek 等 OpenAI 兼容接口后，按当前歌曲的情绪与歌词内容直接产出专属背景与配色，生成结果存进主题库，同类歌曲可复用。
Folium 模组系统（实验性，仅桌面端）：在「设置 → 模组 → 模组系统」中开启后，可以安装第三方模组添加歌词动画、背景类型、播放页图层、进度条按钮与命令，甚至通过 Node 入口调用本地 ffmpeg。模组以可信代码运行，启用前都要在原生窗口确认；官方认证模组带 Folium 签名。仓库mods/目录有覆盖各类能力的示范模组，模组开发指南 讲从第一个模组到提交市场的全流程。
跨设备同步：多设备用户可以自托管官方sync-server（Cloudflare Workers/D1、Docker 或 Node.js + SQLite 三种方式），同步外观设置与 AI 主题库，在「设置 → 连接与集成」填入服务端地址与SYNC_TOKEN即启用。
下一步建议：装好后先放一首带逐字歌词的歌按 H 感受全屏动画，然后去「主题公园」逐个试听主题，最后给本地曲库跑一次批量自动匹配。想深挖动画实现，可以从src/components/visualizer/的registry.tsx与definition.ts入手。
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
