Folia 歌词动画播放器国内安装指南：4 条路线从下载到跑通歌词动画

Folia 歌词动画播放器国内安装指南：4 条路线从下载到跑通歌词动画

【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major

从官方 Releases 下载 Folia 歌词动画播放器安装包时，国内网络速度常被压到几十 KB，甚至中途断开。这篇文章把安装拆成 4 条路线：Windows 与 macOS 走网盘镜像，Arch 走 AUR 包，其他 Linux 发行版用便携版。照着做，十几分钟后歌词动画就能跑在屏幕上。

按环境定路线：30 秒找到你的安装方式

先查表，再翻对应章节：

💡 网盘镜像只有 Windows 与 Apple silicon 的正式版，且可能滞后一个版本。选包前先到项目 Releases 页面核对版本号，网盘入口位置见 README.md 的「直接下载」一节。

从网盘镜像取安装包并核对版本

1. 打开 README 的「直接下载」一节，你会看到夸克网盘与百度网盘两个入口（百度提取码flia）。
2. 转存到自己网盘后下载对应平台的包：Windows 选.exe，macOS 选.dmg且认准 Apple silicon 版本。下载完成后，包大小应与页面标注一致。
3. 双击安装包，按提示点完即可。装好后桌面或开始菜单里会出现 Folia。

桌面版已内置前后端运行环境，Folia 装完无需再配置任何后端。

用 AUR 在 Arch 上装 folia-major-bin

1. 确认机器上有 AUR Helper（yay或paru）。没有就先按 Arch 官方 wiki 装一个，然后验证：

yay --version

预期输出：打印出版本号，说明 Helper 可用。

2. 执行安装：

yay -S folia-major-bin

预期现象：构建会自动从 Releases 拉取folia-major-<版本>-linux-x64.tar.gz，把 Folia 装进/opt/folia-major，并生成folia-major命令与应用菜单里的同名启动项。

3. 到应用菜单点folia-major启动，或在终端复核：

which folia-major

预期输出：/usr/bin/folia-major，命令与桌面集成都就位了。

⚡ 依赖清单（alsa-lib、gtk3、nss等）与构建细节见 packaging/aur/folia-major-bin/PKGBUILD。下载这一步卡住的话，直接翻到文末排错区。

解压便携版包并启动可执行文件

Arch 以外的 Linux 发行版走这条路：

1. 从项目 Releases 页面下载folia-major-<版本>-linux-x64.tar.gz，版本号以页面为准。
2. 解压到一个你记得住的位置：

tar -xzf folia-major-<版本>-linux-x64.tar.gz

预期现象：得到包含folia-major可执行文件和resources/目录的文件夹。

3. 启动：

./folia-major

预期现象：主窗口正常弹出，无黑屏。弹出黑屏直接跳到排错区症状 1。

4. 想放应用菜单？按 packaging/linux/README-LINUX.txt 的步骤，把桌面模板复制到~/.local/share/applications/，再替换__APP_PATH__与__ICON_PATH__两个占位符为实际路径。

跑完 3 个装后验收检查点

逐条勾掉，全过才算装完：

• 主窗口：打开不黑屏、不闪退。
• 音乐源：网易云或本地音乐库任选其一，能连接并浏览到歌曲。
• 歌词动画：点播放，几秒后歌词以全屏动画渲染出来。

💡 接了自建 Navidrome 服务器的话也能浏览整库，下面是连接后的主界面：

处理常见症状：黑屏、构建慢、版本旧

症状 1：Linux 启动后黑屏、透明度异常或闪退

FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major

预期现象：软件渲染启动，窗口显示正常。仍不稳定就再退一格：

FOLIA_LINUX_GRAPHICS_MODE=software ./folia-major

预期现象：最保守的软件渲染模式，稳定性最好。

症状 2：AUR 构建卡在 Releases 下载

1. 手动下载同版本folia-major-<版本>-linux-x64.tar.gz。
2. 放进 AUR 构建源码目录，然后：

makepkg -si

预期现象：构建改用本地包继续，跳过慢速下载，最后正常装好。

症状 3：网盘里的包比官方版本旧

🔁 镜像只覆盖 Windows 与 Apple silicon 正式版且会滞后，以 Releases 页面版本号为准。对不上就直接去 Releases 拿最新包，别在旧版上继续折腾。

Wayland、遥控窗等桌面端细节可查 docs/technical.md。路线选对，剩下的就是等下载条走完——歌词动画在屏幕上跑起来那一刻，折腾就结束了。

【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major