Folia 歌词动画播放器安装：Windows / macOS / Linux 五分钟装完，四条路线全程避坑

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

Folia 是一款歌词动画播放器：它把歌词铺成全屏动画，音源覆盖网易云、酷狗、Navidrome 与本地音乐库。本教程覆盖 Windows、macOS、Linux 三个平台的 Folia 安装，一共四条路线，最快 5 分钟装完。不需要项目背景，会基本终端操作就够。

30 秒选对路线

先拿自己的情况对下表，每条按「谁用 → 包从哪来 → 预计耗时」给出：

1. 国内网络，Windows 或 Apple silicon Mac → 网盘镜像，约 3 分钟。
2. Intel Mac → Releases 页面 dmg，约 5 分钟。
3. Arch / Arch 系，已装 yay 或 paru → AUR 助手一条命令，约 5 分钟。
4. Debian / Ubuntu / Fedora 等非 Arch 系 Linux → Releases 里 linux-x64 便携版手动部署，约 10 分钟。

一个陷阱：网盘只有 Windows 与 Apple silicon 两个包，Intel Mac 和所有 Linux 不必在那里找。

第一步｜拿到正确的包

先取包，包拿错了比装慢更浪费时间。四条路线的取包位置都是固定的：

• 网盘镜像：README.md「快速下载」一节列出夸克与百度两条网盘链接（百度提取码flia）；Windows 取.exe，Apple silicon Mac 取.dmg。
• Intel Mac：项目 Releases 页面取 dmg，认当前版本中标注 Intel 芯片的那个。
• AUR：不用手动下载，yay或paru会在构建时从 Releases 拉 linux-x64 包。
• 便携版：Releases 页面取当前版本的 linux-x64 包，文件名形如folia-major-<version>-linux-x64.tar.gz。

第二步｜按平台装完它

按路线执行安装，四个分支从最快的开始排。

Folia 网盘下载怎么装 Windows 与 Apple silicon

1. 先核对版本号，与最新 release 明显脱节就转去 Releases 页面。
2. Windows 双击.exe安装器，按提示走完；Apple silicon Mac 挂载.dmg，把Folia.app拖进 Applications。
3. 从开始菜单或 Applications 启动 Folia。

避坑提示｜网盘只有 Windows 与 Apple silicon 两个包；链接失效时，以README.md「快速下载」的最新镜像链接为准。

Folia Mac dmg 怎么装 Intel Mac

1. 从项目 Releases 页面取 dmg，认当前版本、标注 Intel 芯片的那个。
2. 挂载后把Folia.app拖进 Applications，别在挂载卷里直接运行。
3. macOS 首次启动弹出「应用已损坏」或「无法验证」，是下载隔离属性在拦，终端移除：

xattr -dr com.apple.quarantine /Applications/Folia.app # 移除隔离属性后再从 Applications 打开

避坑提示｜macOS 版目前未走 Developer ID 签名与公证，Gatekeeper 拦首次启动属正常行为；之后每次手动重装，上面那条xattr命令都要再跑一遍。

Folia AUR 怎么一条命令装进 Arch

1. 先确认 AUR 助手在：

yay --version # 确认 AUR 助手已安装

2. 安装预编译二进制包，paru 用户把命令名换成paru：

yay -S folia-major-bin # 构建时从 Releases 拉取 linux-x64 包，装进 /opt/folia-major

3. 包会在/usr/bin建软链接，一条命令验证：

which folia-major # 应输出 /usr/bin/folia-major

4. 到应用菜单里找到 Folia，启动。

避坑提示｜AUR 包当前版本0.1.4，依赖alsa-lib、gtk3、libxss、nss四样，可在packaging/aur/folia-major-bin/PKGBUILD逐项核对；构建卡在下载步骤就别干等，直接转下面的便携版。

Folia Linux 便携版怎么部署到 Debian / Ubuntu / Fedora

1. 到 Releases 页面取当前版本 linux-x64 包，文件名形如folia-major-<version>-linux-x64.tar.gz。
2. 解压后放进一个固定目录：

mkdir -p ~/Apps/Folia && tar -xzf folia-major-*-linux-x64.tar.gz -C ~/Apps/Folia # 整套程序放进固定目录

3. 包内自带的桌面项模板，复制到用户级应用目录：

cp ~/Apps/Folia/resources/linux/folia-major.desktop ~/.local/share/applications/ # 复制桌面项模板

4. 打开复制出的.desktop，两处占位符都填绝对路径：__APP_PATH__填folia-major可执行文件，__ICON_PATH__填resources/linux/icon.png。
5. 桌面环境有要求时，把该.desktop标记为可信，再从应用菜单启动 Folia。

避坑提示｜便携包里一共三样：folia-major可执行文件、resources/linux/icon.png和桌面项模板；排查问题时先确认可执行文件与resources/在同一个便携包内。

第三步｜3 个自检查是否装好

启动 Folia，按顺序勾掉这三项，全部成立即安装成功：

• 应用菜单里出现 Folia（Windows 看开始菜单，macOS 看 Applications，Linux 看应用菜单）
• 打开后进入首页，歌单 / 文件夹标签页与搜索框都在
• 随便播放一首歌，全屏歌词动画动起来了

Linux 启动后出现黑屏、透明度 / 模糊异常或 GPU 崩溃，先别怀疑装坏了，多是图形路径问题。强制走 swiftshader 软件渲染：

FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major # 以软件渲染方式启动

swiftshader 下仍不稳，把变量值改成software，即最保守的软件渲染档位。

问题速查：卡住了看这里

上面哪一步卡住，直接对号入座，每条回答不超过两行。

Q：网盘里找不到 Intel Mac 或 Linux 的包？A：网盘不用找了，去 Releases 页面取对应平台的包。

Q：网盘版本落后或链接失效？A：以README.md「快速下载」一节的最新镜像链接为准。

Q：AUR 构建卡在下载步骤？A：别干等，放弃 AUR，转 linux-x64 便携版手动部署。

Q：macOS 弹「应用已损坏」或「无法验证」？A：终端执行xattr -dr com.apple.quarantine /Applications/Folia.app移除隔离属性。

Q：Linux 启动黑屏、透明度异常或 GPU 崩溃？A：用FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major启动。

Q：swiftshader 下仍不稳定？A：改用FOLIA_LINUX_GRAPHICS_MODE=software ./folia-major，最保守档位。

Q：桌面快捷方式不显示？A：检查.desktop的Exec/Icon是否填了绝对路径，并把文件标记为可信。

装完之后去哪

Folia 装完，仓库内这几份文档按顺序读一遍：

• docs/technical.md：Linux 图形模式、Wayland / Hyprland 遥控窗等桌面端细节，黑屏的进阶解法都集中在这。
• packaging/linux/README-LINUX.txt：便携包说明书，包里三样东西与全部图形环境变量一次讲清。
• packaging/aur/folia-major-bin/PKGBUILD：AUR 包的依赖、安装路径与软链接逻辑，可逐项核对。
• docs/local-library-management.md：装完之后的本地音乐库导入、重扫与在线歌词匹配玩法。
• deploy/docker/README.md：不想装桌面端时的备选，Docker Compose 全栈部署 Web 版本。

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