Folia 完全上手指南：把每首歌变成全屏歌词 PV，从安装到主题调优
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
Folia 是一款以全屏歌词动画为核心的开源音乐播放器，支持网易云、酷狗、QQ 音乐、Navidrome 在线播放与本地音乐库。本文带你走通安装、播放第一首歌、进入全屏歌词舞台、调出专属动画主题的完整流程。
先搞懂：Folia 和普通播放器差在哪
普通播放器把歌词挤在角落，Folia 则把歌词当成舞台主角——项目里的口号叫Lyrics Reimagined（辞曲新境）。它解决的核心问题是：让"听歌"变成"看一场只属于你的文字动画"。
| 能力 | 一句话解释 |
|---|---|
| 全屏歌词动画 | 十余种排版风格各异的动画主题，歌词按节奏铺满整个屏幕 |
| 多平台音源 | 在线搜索网易云、酷狗、QQ 音乐，也可接入 Navidrome 自建曲库 |
| 本地曲库 | 导入文件夹即可播放，自动读取同目录歌词与内嵌封面，不上传音频内容 |
| AI 主题生成 | 按歌曲情绪与歌词内容自动产出背景与配色 |
| 效率向交互 | 命令面板 + 全键盘操作，播放过程中基本不用碰鼠标 |
桌面端基于 Electron（自带前后端运行环境），另有 Web 版本可部署或装成 PWA（Progressive Web App，可"添加到桌面"当 App 用的网页应用）。
Folia 安装指南：按系统选对包
桌面版是最省心的选择，装完双击就能用：
- Windows / macOS：下载最新 Release 安装包直接安装，Apple Silicon 芯片有专属版本；
- Linux：Debian/Ubuntu 选
.deb，Fedora 选.rpm，Arch 用户可在 AUR 安装folia-major-bin，其他发行版解压tar.gz运行即可。
不想装桌面端的话，Web 版本可一键部署到 Vercel 或 Cloudflare，移动端部署后用浏览器"添加到主屏幕"就能当 PWA 用；有 NAS 的用户还可以用仓库里的 deploy/docker/README.md 做 Docker Compose 全栈自托管。
💡 首次启动会弹出欢迎引导页，把命令面板、即时搜索等核心操作过一遍，后面少走弯路。
Folia 在线音乐播放：搜索、播放与音源回退
想听什么直接搜，流程只有三步：
- 在首页顶部搜索框输入歌曲名、歌手或专辑名，支持中文拼音联想；
- 点击搜索结果中的歌曲开始播放，封面与歌词自动加载；
- 在播放控制区点+把歌曲加入队列，攒出自己的临时歌单。
音源层面有个兜底机制：某个平台不可用时，Folia 会自动回退到下一个可用来源，匹配顺序大致是网易云、QQ 音乐、酷狗，不需要手动切换配置。
即时搜索是藏在细节里的体验：在任意歌曲列表里直接敲键盘打字就能触发搜索，不必先点进搜索框。
Folia 本地音乐库：导入文件夹与歌词自动匹配
如果你的收藏在本机，本地曲库开箱即用：
- 进入首页的本地音乐（Folder）区域；
- 点击Import Folder（导入文件夹），选择音乐目录；
- 等待后台扫描完成，专辑封面与内嵌歌词自动读取。
歌词来源方面，同目录下与音频同名的.lrc、.vtt、.ttml、.qrc、.yrc、.krc文件都会被自动识别，并适配 LDDC 生成的增强逐字歌词。本地歌曲还支持智能歌词匹配：通过在线音源自动补全缺失的歌词与封面，匹配不准时可以手动修正。
💡 完整玩法（重扫、实体编辑、歌单、缓存与故障排查）见仓库内的 docs/local-library-management.md。
Folia 全屏歌词舞台：动画主题与主题公园
进入全屏舞台的操作路径很短：
- 播放中按H隐藏播放器控件，画面只剩歌词动画；
- 进入设置 → 视觉切换动画主题；
- 每个主题都带独立参数面板，动画节奏、字幕显示、背景风格都能逐项微调；
- 按P展开右侧面板可切换歌词来源（在线 / 内嵌 / 本地），Tab切换面板选项卡；
- 按F11铺满整块屏幕，效果最完整。
内置主题风格跨度很大：经典款浮名、流光，3D 的镜台、时计，拼贴风的凝彩，还有把歌词做成群聊对话的群唱、心象、云阶、倾诉等。
拿不准选哪个时，去主题公园（Theme Park）一边试听一边对比预览，找到最合心意的"舞台"。动画均为响应式布局，窗口放大到多大，歌词就铺到多大。
Folia 快捷键速查：少用鼠标的六把钥匙
| 快捷键 | 功能 |
|---|---|
Space | 播放 / 暂停 |
S | 打开命令面板（几乎所有功能的入口） |
Ctrl + P | 打开播放队列 |
Ctrl + → / ← | 下一首 / 上一首 |
H | 隐藏播放器控件，只剩歌词画面 |
F11 | 全屏 |
Folia 源码构建与部署：给想折腾的人
从源码运行需要 Node.js ≥ 24：
git clone https://gitcode.com/GitHub_Trending/fo/folia-major cd folia-major npm install npm run dev部署相关的环境变量、QQ 音乐 API 配置与排错方法，可查阅 docs/technical.md 与 docs/qq-music-deployment.md。
装完之后的下一步清单
- 把一首最熟的歌设为收藏，按
H看它变成全屏歌词动画； - 进主题公园把五个主题各试听一遍，记下参数面板里最值得调的几项；
- 挑一个音乐文件夹导入本地曲库，验证同目录
.lrc是否被识别； - 想换台设备继续用，再研究 deploy/docker/README.md 的自托管方案。
一句话推荐：如果你受够了"歌词只在角落里滚动"的播放器，Folia 值得装一次——先按H，然后看它把你最熟的那首歌变成什么样子。
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
