Folia 歌词动画播放器：国内下载安装完整指南

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

Folia 是一款支持本地音乐与多个在线平台的桌面歌词动画播放器。国内直连 GitHub Releases 下载常被限速甚至中断，本文把网盘镜像、Linux 便携版、AUR 三条官方途径整理清楚，每条只需几步操作。

先判断你属于哪种用户

本节帮你十秒内锁定自己要走的路。

• Windows 或 Apple silicon 的 Mac：走网盘镜像，看「Windows 与 macOS」一节；
• 其他 Linux（Ubuntu、Debian、Fedora 等）：网盘未覆盖，用便携版 tar.gz，看「其他 Linux」一节；
• Arch Linux（含 Manjaro 等 Arch 系发行版）：AUR 最省事，看「Arch」一节。

Windows 与 macOS：用网盘镜像拿安装包

本节解决「Windows 和 macOS 的安装包从哪里下载」。

1. 打开仓库的 README.md，定位「直接下载」小节；
2. 点进夸克网盘或百度网盘链接（百度网盘提取码flia），先转存到自己的网盘，再执行下载；
3. Windows 选.exe，macOS（Apple silicon）选.dmg，双击完成安装。桌面版已内置运行环境，装完即用。

其他 Linux：解压便携版 tar.gz 即用

本节解决「没有 AUR 的 Linux 怎么装 Folia」。

1. 到仓库的 Releases 页面，下载folia-major-<版本号>-linux-x64.tar.gz（此命名与 AUR 构建脚本拉取的完全一致）；
2. 解压到任意固定目录，双击目录内的folia-major可执行文件即可启动；
3. 可选：创建桌面启动项。

# 把解压目录里的桌面项模板复制到用户应用目录 cp <解压路径>/resources/linux/folia-major.desktop ~/.local/share/applications/ # 再把复制出的文件里 __APP_PATH__ 与 __ICON_PATH__ 两处占位符改为真实绝对路径

占位符改法详见 packaging/linux/README-LINUX.txt。

Arch 上一条命令装好 Folia

本节解决「Arch 用户如何免去手动配置」。

1. 确认已装 AUR 助手——社区提供的包管理工具。没有的话按 Arch wiki 先装一个 yay；已有 paru 的可以直接用；
2. 在终端执行：

# 安装 AUR 包，程序放入 /opt/folia-major，依赖自动处理 yay -S folia-major-bin

3. 构建完成后，应用菜单里即有folia-major启动项。构建逻辑见 packaging/aur/folia-major-bin/PKGBUILD，版本同步脚本见 packaging/aur/folia-major-bin/update.sh。

验证安装成功：三类用户各自的检查点

本节集中回答「到底装好没有」。

• Windows / macOS：开始菜单或 Launchpad 里能找到 Folia 图标，启动后直接进入全屏歌词画面；
• 其他 Linux：应用菜单出现 Folia 条目；在解压目录执行./folia-major能弹出主窗口；
• Arch：终端执行下面命令，输出中出现folia-major-bin条目、版本号与 AUR 页面一致即完成：

pacman -Qs folia-major

排错：黑屏、版本滞后与 AUR 构建慢

Linux 启动黑屏、透明度或模糊异常→ 显卡渲染兼容问题 → 改用软件渲染启动：

# swiftshader 为软件渲染，绕过 GPU FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major

仍不稳定，把变量值换成software，是最保守的方案。

网盘里的包和最新版对不上→ 镜像同步有延迟 → 以 README「直接下载」小节为准，并到 Releases 页面核对版本号。

AUR 构建卡在压缩包下载→ Releases 拉取速度慢 → 自行下好同版本 tar.gz，放入 AUR 构建源码目录后，再执行makepkg -si。

按你的系统对号入座，几分钟就能跑起 Folia 的沉浸式歌词动画 🎧

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