Folia 下载安装:5 分钟跑通三平台歌词动画播放器
Folia 是一款把歌词渲染成全屏动画的在线音乐播放器,支持网易云、酷狗、QQ 音乐、Navidrome 与本地音乐库。这篇文章带你走一遍 Windows、macOS、Linux 三个平台的下载安装流程:先定包的路径,再装,装完验收,跑不起来时看最后两节。
装之前:先花 30 秒确认包在哪
下载前只需要回答一个问题:你的平台是什么,网络环境是什么。
结论先说:国内网络 + Windows 或 Apple silicon Mac,走项目网盘,链接在 README.md 的「快速下载」一节(夸克、百度两条,百度提取码 flia),国内速度最稳。但网盘只有这两个平台的包,Intel Mac 和所有 Linux 都不要在里面找。
- Intel Mac:去项目 Releases 页面取 dmg,因为网盘里没有这个包。
- Arch / Manjaro 且已装 yay 或 paru:走 AUR 助手一条命令,自动程度最高。
- Debian / Ubuntu / Fedora 等:Releases 拿 linux-x64 便携版,手动部署。
顺手对比一下网盘里的版本号和最新 release,明显滞后就改用 Releases。
安装过程:按平台各走三步
路径定了之后,每个平台的安装都不长,跟着做即可。
Windows 与 Apple silicon Mac:网盘最省事
- 打开仓库 README.md 的「快速下载」一节,取网盘链接。
- Windows 拿
.exe,macOS 拿.dmg。 - Windows 双击安装器按提示走完;macOS 挂载 dmg,把
Folia.app拖进 Applications,别直接在挂载盘里运行。 - 从开始菜单或 Applications 启动。
Intel Mac:首次启动要用 xattr 解一次
- 进 Releases 页面,下载当前版本、对应 Intel 芯片的 dmg。
- 挂载后把
Folia.app拖入 Applications。 - 首次启动被提示「应用已损坏」或「无法验证」属正常现象:当前 macOS 版没有 Developer ID 签名与公证,Gatekeeper 拦的是下载隔离属性,在终端移除它:
xattr -dr com.apple.quarantine /Applications/Folia.app # 移除下载隔离属性,Gatekeeper 不再拦截
这里有个小坑:macOS 版不支持应用内自动更新,之后每次手动重装覆盖,都要再执行一遍这条 xattr 命令。
Arch 系:一条 AUR 命令
先确认助手可用(yay --version),然后:
yay -S folia-major-bin # 构建时从 Releases 拉 linux-x64 包,装进 /opt/folia-major
paru 用户把命令名换成 paru。装完验证命令可直接执行:
which folia-major # 应输出 /usr/bin/folia-major
再到应用菜单里启动 Folia。构建如果卡在下载步骤,多半是网络问题,别干等,直接转下面的便携版。包的依赖(alsa-lib、gtk3、libxss、nss)可在 packaging/aur/folia-major-bin/PKGBUILD 逐项核对。
其他 Linux 发行版:便携版手动部署
官方对非 Arch 系只给便携包这一种形态,里面一共三样东西:folia-major 可执行文件、resources/linux/icon.png 和桌面项模板。
- 到 Releases 下载当前版本的
folia-major-<version>-linux-x64.tar.gz。 - 解压到一个固定目录:
mkdir -p ~/Apps/Folia && tar -xzf folia-major-*-linux-x64.tar.gz -C ~/Apps/Folia # 整套程序放进一个目录
- 把自带的桌面项模板复制到用户级应用目录:
cp ~/Apps/Folia/resources/linux/folia-major.desktop ~/.local/share/applications/ # 注册应用菜单启动项
- 打开复制出的
.desktop,把__APP_PATH__填成folia-major可执行文件的绝对路径,__ICON_PATH__填resources/linux/icon.png的绝对路径。 - 桌面环境有要求时,将该
.desktop标记为可信,然后从应用菜单启动。
包内的说明书 packaging/linux/README-LINUX.txt 有同样的步骤,桌面快捷方式不显示时优先回去对照这一节。
装完之后:验证歌词动画真的跑起来
上面讲完,收个尾——不分平台、不分装法,满足这三条即视为装好。
- 应用菜单里出现 Folia 条目(Windows 看开始菜单、macOS 看 Applications、Linux 看应用菜单)。
- 点开后能进入首页,看到歌单 / 文件夹标签页和搜索框。
- 随便播放一首歌,全屏歌词动画真的动起来。
Linux 启动后如果出现黑屏、透明度 / 模糊异常或 GPU 崩溃,先别怀疑装坏了,通常是图形路径问题。用环境变量强制走软件渲染:
FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major # 以软件光栅化路径启动
swiftshader 下仍不稳定的话,把变量值改成 software,即最保守的软件渲染档位。
装不上时:常见故障逐个对照
前面没覆盖的情况,按"如果…就…"逐条过一遍。
- 如果网盘里找不到自己平台的包(Intel Mac / Linux):网盘里没有,去 Releases 页面取对应平台的包。
- 如果网盘版本落后于最新 release 或链接失效:以 README.md「快速下载」一节的最新镜像链接为准。
- 如果 AUR 构建卡在下载步骤:放弃 AUR,转 linux-x64 便携版手动部署。
- 如果 macOS 提示「应用已损坏」或「无法验证」:终端执行上面那条
xattr命令;「无法验证」也可以走「系统设置 → 隐私与安全性 → 仍要打开」,但「已损坏」提示没有这个入口,只能走xattr。 - 如果桌面快捷方式不显示:检查
.desktop的Exec/Icon是否填了绝对路径,并把文件标记为可信。
进一步阅读
- docs/technical.md:Linux 图形模式、Wayland / Hyprland 遥控窗等桌面端细节,黑屏问题的进阶解法都在这。
- packaging/linux/README-LINUX.txt:便携包自带的说明书,讲清包里三样东西和全部图形环境变量。
- packaging/aur/folia-major-bin/PKGBUILD:AUR 包的依赖、安装路径与软链接逻辑,逐项可核对。
- docs/local-library-management.md:装好之后本地音乐库的导入、重扫与在线歌词匹配玩法。
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考






