Folia 上手指南：6 个问题，让整块屏幕变成全屏歌词动画
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
Folia 是一款围绕全屏歌词动画做的开源音乐播放器：按一个键就进舞台，歌词成为屏幕上唯一的内容。它接入网易云、酷狗、QQ 音乐、Navidrome，也能直接播放你本机的音乐文件夹，从哪进都能放起来。
这篇文章按新手最常问的 6 个问题来写：怎么装、怎么放出第一首歌、动画主题在哪换、快捷键记哪几个、卡住了怎么办、怎么从源码跑起来。顺着读一遍，十分钟之内你的第一首歌会"亮灯"。
一、Folia 去哪下载？
桌面版内置前后端运行环境，装完打开就能用；Web 版是另一回事，坑点见第五节。三端的下载路径：
- Windows：到项目 Releases 页面下载最新安装包，双击安装；
- macOS：Apple Silicon 专属版本，下载后拖进应用程序；
- Linux：Debian/Ubuntu 用
.deb，Fedora 用.rpm，Arch 从 AUR 装folia-major-bin，其他发行版解压tar.gz后直接运行folia-major。
二、第一首歌怎么放成全屏歌词？
不用任何配置，四步走完：
- 启动后首页就有搜索入口、电台、专辑和本地音乐区域；
- 顶部搜索框输入歌名或歌手名，支持中文拼音联想；
- 点一首结果，点开即播，封面和歌词自动加载；
- 按
H，播放器控件消失，屏幕只剩歌词。
此刻就是你的第一个舞台：歌词跟着旋律逐字展开，封面安静地立在旁边。
播的是本地歌？同目录同名.lrc、.vtt、.krc歌词文件会被自动读取，缺失的歌词和封面也能从在线音源自动补齐。
三、歌词动画主题在哪换？
打开设置进"视觉"分区，或者在命令面板里搜"歌词动画"直接跳过去。
内置 8 种歌词动画主题：浮名、流光、心象、云阶、群唱、倾诉、镜台、时计。选中后参数面板展开，动画节奏、字幕显示、背景风格都能微调，布局随窗口大小自动适配。拿不准就逛主题公园，每个主题都能边试听边预览。
浮名：金白色大字浮在深蓝夜色上，背景里旧歌词轻轻游动。
群唱最特别：歌词被排成一条条聊天气泡，带头像和时间戳，一首歌变成一场群聊。
镜台用 3D 粒子和细线搭出一个小舞台，主歌在光点之间浮起来。
其余五种同理。还有一步进阶：AI 主题生成会读取歌曲的情绪与歌词内容，给这首歌配专属背景和色板。
四、键盘党该记哪几个键？
| 快捷键 | 作用 |
|---|---|
Space | 播放 / 暂停 |
Ctrl + K | 打开命令面板，功能与设置都能搜 |
Ctrl + P | 在命令面板里打开播放队列 |
Ctrl + → / ← | 下一首 / 上一首（macOS 用⌘） |
H | 隐藏播放器控件，只看歌词 |
P+Tab | 打开右侧面板并循环切换选项卡 |
鼠标能做的事，基本都能在命令面板里找到对应命令。
五、搜不到歌、没声音怎么办？
三个常见坑，各用一行讲清：
- Web 版搜不到歌或没声音→ Web 版不含内置后端，需自行部署网易云 API 服务 → 直接用桌面版省事，部署方法见 docs/technical.md；
- Vercel/Cloudflare 上 QQ 音乐放不了→ 该形态必须先微信扫码登录，且要配
VITE_QQ_API_BASE（填/api/qq）和QQ_SESSION_SECRET→ 完整排错步骤见 docs/qq-music-deployment.md； - Linux 窗口黑屏或起不来→ 显卡驱动与合成器冲突 → 用
FOLIA_LINUX_GRAPHICS_MODE=swiftshader（或software）启动。
六、想从源码跑起来？
需要 Node.js ≥ 24：
git clone https://gitcode.com/GitHub_Trending/fo/folia-major cd folia-major npm install npm run devWeb 版可以一键部署到 Vercel 或 Cloudflare；Docker Compose 全栈自托管的配置在 deploy/docker/README.md。本地曲库的导入、重扫与实体合并看 docs/local-library-management.md；歌词动画本体的实现则在 src/components/visualizer/。
打开设置里的视觉分区，给下一首歌换个主题，舞台又会变一次。
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
