Folia 安装指南：十分钟把歌词变成节拍动画，三平台通用的全屏歌词播放器
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
深夜戴上耳机，想让歌词跟着节拍铺满整个屏幕。Folia 正是这样的全屏歌词播放器：把歌词渲染成节拍动画，本地曲库与网易云、QQ 音乐、酷狗、Navidrome 都能接上。接下来十分钟，完成 Folia 下载与安装。
Folia 安装前 30 秒自检
动手下载前，回答三个问题，路线就定下来了：
| 检查项 | 你的情况 | 对应路线 |
|---|---|---|
| 系统是什么 | Windows / macOS | 路线 A：图形化安装 |
| Arch / EndeavourOS | 路线 B：AUR | |
| 其他 Linux | 路线 C：便携版 | |
| 海外直连顺不顺 | 顺 | 官方 Releases |
| 经常断 | 网盘镜像（仅 Windows / Apple silicon） | |
| 愿不愿用终端 | 愿意 | 路线 B / C |
| 不愿意 | 路线 A |
Folia 下载通道对照
| 通道 | 可用平台 | 适合谁 | 预计耗时 |
|---|---|---|---|
| 官方 Releases | Windows / macOS / Linux 全平台 | 直连顺利；Linux 包唯一来源 | 5-10 分钟 |
| 网盘镜像（夸克 / 百度） | Windows、Apple silicon | 海外直连慢、需要断点续传 | 5-10 分钟 |
| AUR（folia-major-bin） | Arch / EndeavourOS | 熟悉终端、想一条命令装完 | 3-5 分钟 |
💡 网盘入口在 README.md 的「快速下载」一节，先转存到自己网盘再下载，百度网盘提取码flia。
路线 A：Folia Windows 与 macOS 图形化安装
Folia Windows 安装包下载与安装
- 打开 README.md 的「快速下载」一节，拿 Windows 包链接。
- 走网盘就先转存到自己网盘再下载，断了能续传。
- 双击
.exe安装包运行，按向导走到「完成」按钮；运行环境已内置，不装额外依赖。 - 桌面出现 Folia 快捷方式，双击启动，主界面出现。
- 在设置里打开关于页，显示的版本号应与下载文件名里的数字一致。
⚠️ 只用 README 列出的官方网盘入口，装前核对文件名里的版本号，避免来路不明的转发包。
Folia macOS dmg 安装与 Gatekeeper 拦截处理
- 下载 Apple silicon 版
.dmg，文件名形如Folia-<版本>-arm64.dmg；Intel 版只在 Releases 页。 - 打开 dmg，把
Folia.app拖进Applications，别在挂载盘里直接运行。 - 首次启动。若弹「应用已损坏」或「无法验证开发者」，是当前构建没有 Apple Developer ID 签名，属已知情况，不是包坏了。
- 在终端执行这一行：
# 移除下载隔离属性，Gatekeeper 不再拦截 xattr -dr com.apple.quarantine /Applications/Folia.app- 从 Applications 再打开一次，这次主界面应正常出现。
⚠️ macOS 版没有应用内自动更新，每次覆盖安装新版本后隔离属性会回来，这行xattr要重跑一遍，详解见 docs/desktop/macos-app-damaged.md。
路线 B：Folia AUR 安装，一条命令
适用 Arch / EndeavourOS。
- 确认 AUR Helper 就绪：
yay --version能输出版本号；用 paru 就把下面的命令换成 paru。 - 一条命令安装：
# 从 AUR 安装，依赖自动解决 yay -S folia-major-bin- 构建过程会一起装上
alsa-lib、gtk3、libxss、nss等依赖，完整清单见 packaging/aur/folia-major-bin/PKGBUILD。 - 装完程序落在
/opt/folia-major，应用菜单出现folia-major入口，点开主界面出现。
路线 C：Folia Linux 便携版免安装部署
适合非 Arch 系发行版。解压即用，不需要 root，不改系统。
- 去 Releases 页下载
folia-major-<版本>-linux-x64.tar.gz。Linux 包只有这里有，网盘镜像没有。 - 解压到任意目录，比如
~/Apps/Folia，包内顶层是folia-major可执行文件与resources/目录。 - 在终端运行可执行文件：
# 进入解压后的目录，运行可执行文件 ./folia-major- 窗口出现即验证安装成功；关掉终端窗口不影响应用运行。
- 想要桌面入口：把包内
resources/linux/folia-major.desktop模板复制到~/.local/share/applications/，把__APP_PATH__、__ICON_PATH__占位符换成实际路径，桌面环境有要求时再把这个文件标记为可信，完整流程见 packaging/linux/README-LINUX.txt。
Folia 首启验收清单
逐条对照，四项都过才算装好：
- 能启动：快捷方式 / 应用菜单 / 可执行文件，主界面出现，左上角 Folia 标识与搜索框就位。
- 版本对得上：关于页里的版本号，与下载文件名里的数字一致。
- 核心走通：放一首带歌词的歌，歌词进入全屏动画并随节拍跳动。
- 风格可换：设置里切换主题，动画实时变化。
Folia 常见故障速修
[Windows] 下载卡住或反复中断换官方夸克 / 百度网盘镜像，转存后再下载即可续传。
[macOS] 提示「应用已损坏，请移到废纸篓」
# 移除隔离属性，再从 Applications 重新打开 xattr -dr com.apple.quarantine /Applications/Folia.app[Linux] 黑屏、透明度异常或启动闪退
# 以 swiftshader 软件渲染模式启动 FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major仍不稳定把取值改为software；要恢复系统图形路径用system。
[Arch] AUR 构建拉包卡住先手动下好同版本folia-major-<版本>-linux-x64.tar.gz放进 AUR 源码目录，再本地构建：
# 用本地源码包构建并安装 makepkg -si[全平台] 网盘版本比 Releases 旧把文件名里的数字与 Releases 页最新版本比对，不一致就等同步或改直连。
Folia 装完之后：主题、Web 版与模组
装完不等于玩完，三件事接着做：
- 换主题：在设置里切换歌词动画主题，开头的浮名与下图流光是两种气质。
- 跑 Web 版：NAS 或手机浏览器场景，走 deploy/docker/README.md 的 Docker Compose 全栈部署。
- 装模组：桌面版 Folium 模组平台可新增歌词动画与背景类型，见 mods/README.md。
路线已定，包也到手。现在就去「快速下载」一节把对应系统的包拿下来，下一首歌放出来，歌词就会铺满整个屏幕。
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
