Folia 五分钟上手:本地音乐进全屏歌词动画的最短路径
Folia 是一款把全屏歌词动画放在核心位置的音乐播放器,本地曲库、Navidrome、网易云、QQ 音乐、酷狗都能接。照做完安装、导入、播放三件事,当控制条消失、歌词铺满屏幕的那一刻,就算跑通了。
Folia 最快安装方式:桌面版与本地 Web 版
两条路任选,装完打开都是完整界面。
- 桌面版(推荐):从 Releases 下载对应平台安装包(Windows / macOS / Linux),前后端环境已内置,即装即用。
- 本地跑 Web 版:准备 Node.js 24 及以上,
git clone https://gitcode.com/GitHub_Trending/fo/folia-major克隆仓库,再依次执行npm install与npm run dev,浏览器打开即完整 Folia。
启动后认准三处:顶部页签条(Playlists / Radio / Albums / Folder / Navi)决定翻哪个库;右上角搜索框管在线搜歌;右下角悬浮按钮是各平台的登录入口。
三种歌曲来源怎么选:本地曲库、Navidrome、在线平台
歌从哪来,先定一个。
- 本地曲库:走
Folder页签,音乐在自己电脑上,不用账号,新手最省心; - Navidrome:走
Navi页签,在设置里填好服务器地址,适合自建音乐服务器; - 在线平台:右上角搜索框直接搜,未登录时部分歌曲只开放 30 秒试听。
第一次用建议直接选本地曲库:不依赖网络登录,打开就能听。
导入本地音乐:五步播起第一首歌
最短路径五步,每步都不超过十秒。
- 点顶部
Folder页签; - 点工具栏 Import Folder,在系统目录选择器里选中音乐目录;
- 等扫描完成:Folia 会递归读子目录的音频、同目录
.lrc歌词与内嵌封面,大目录稍等片刻; - 点进
All Songs,单击任意歌曲开始播放; - 全屏歌词页按一次
H:控制条消失,歌词动画铺满屏幕——这就是 Folia 的招牌体验。
走在线平台更短:搜索框输入歌名或歌手,结果里单击即播;歌曲菜单选「收藏」可留存,成功会提示「已添加到喜欢的音乐」。
Folia 播放快捷键速查:不碰鼠标也能听
进入播放状态后,高频操作全部交给键盘:
| 操作 | 按键 | 说明 |
|---|---|---|
| 播放 / 暂停 | Space | 用得最多的一个键 |
| 上一首 / 下一首 | Ctrl + ← / Ctrl + → | macOS 换成 Cmd |
| 快退 / 快进 5 秒 | ← / → | 进度微调不用点进度条 |
| 打开命令面板 | S | 汉字、拼音都能触发 |
| 打开队列面板 | Ctrl + P | macOS 为 Cmd + P |
| 隐藏 / 显示控制条 | H | 专注全屏歌词动画 |
💡 命令面板按 S 打开后,输入「切歌」「收藏」这类词直接执行,比逐层翻菜单快得多。完整按键定义见 src/components/modal/userGuideContent.ts。
三个新手常见故障:30 秒试听、权限收回、导入失败
- 在线歌曲 30 秒就停:未登录只有试听额度。点右下角悬浮按钮展开平台入口,扫码登录即可完整播放,在线歌单与收藏一并解锁。
- 重启后本地曲库变灰、歌曲播不了:系统收回了目录读取权限。看到「需要恢复本地音乐访问权限」就按提示重新授权;目录被移动或改名则重新导入。
- Web 版提示不支持文件夹导入:该能力依赖浏览器的 File System Access API,换支持的浏览器或直接上桌面版。
⚠️ 目录里混着临时音频时,在根目录放一个 .foliaignore 排除,语法与 .gitignore 相同,重新导入后生效。更多规则见 本地音乐库管理。
跑通之后的三件值得做的事
「导入 → 播放 → 切歌 → 收藏」都通了,接着可以:
- 换全屏歌词动画主题,浮名、流光、群唱等风格的效果预览在 README 主题展示区;
- 给本地歌曲自动匹配在线歌词与封面,匹配策略和整理规则在 docs/local-library-management.md;
- 部署、环境变量与 Stage API 等进阶内容看 docs/technical.md。
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考






