Folia 安装教程：歌词全屏动画播放器的国内下载与三平台落地方案
项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major Folia 是一款以全屏沉浸式歌词动画为核心的音乐播放器，同时接入网易云、QQ 音乐、酷狗、Navidrome 和本地音乐库，让歌词以接近文字 PV 的方式铺满整个屏幕。官方 Releases 在国内直连经常限速或中断，这篇 Folia 安装教程按你的系统给出三条路线：Windows / macOS 走官方网盘镜像，Arch 走 AUR 一条命令，其他 Linux 用便携版压缩包手动落地，全程不需要编译源码。
先看一眼系统，确定你的下载入口
动手前花 10 秒确认三件事：操作系统、包管理器、是否有解压与编辑文件的权限。对照下表选路线即可：
| 你的环境 | 获取方式 | 耗时 | 前置条件 |
|---|---|---|---|
| Windows / macOS | 官方网盘镜像（夸克 / 百度） | 约 5 分钟 | 夸克或百度客户端账号 |
| Arch Linux | AUR 包 folia-major-bin | 一条命令 | 已装 yay 或 paru |
| 其他 Linux 发行版 | 便携版 tar.gz 解压 + 手动启动项 | 约 10 分钟 | 解压与编辑文件权限 |
⚠️ 无论走哪条路线，只认 README 里的官方入口，第三方转发包一律不用。
Windows / macOS：从官方网盘转存后双击安装
桌面版内置前后端运行环境，装完免配置，所以拿到对应平台的安装包是唯一目标。
- 打开 README 的「快速下载 / 直接下载」小节，复制官方网盘入口（夸克或百度均可）；
- 在客户端登录账号，把文件转存到自己网盘——网盘只覆盖 Windows 与 Apple silicon 的正式版安装包；
- 下载对应平台的安装包：Windows 选
.exe，macOS 选.dmg（Intel Mac 请自行确认版本，网盘只提供 Apple silicon 正式版）； - 双击安装包运行，跟随引导完成安装。
百度网盘入口有提取码，README 中一并给出了。
Arch：用 yay 或 paru 一条命令装进 AUR
Arch 上 Folia 已进 AUR，包名 folia-major-bin。构建时 alsa-lib、gtk3、libxss、nss 等依赖由 AUR Helper 自动解析：
# 二选一，在你的终端里执行
yay -S folia-major-bin
paru -S folia-major-bin
装完的落点是固定的：程序在 /opt/folia-major，命令入口为 /usr/bin/folia-major，应用菜单里会出现 Folia 启动项。打包逻辑可以在仓库里查证：PKGBUILD 与桌面启动项模板。
⚡ 提速技巧：AUR 构建时会从 Releases 拉取 folia-major-<版本>-linux-x64.tar.gz。如果这一步慢，先把同版本压缩包从网盘下到 AUR 构建的源码目录，再执行 makepkg -si，即可跳过慢速下载。
其他 Linux：解压便携版，替换 .desktop 里的两处路径
从网盘拿到 folia-major-<版本>-linux-x64.tar.gz 后，在目标目录执行 tar -xzf 解压，会得到三样东西：
folia-major：可执行文件resources/linux/folia-major.desktop：启动项模板resources/linux/icon.png：应用图标
然后手动创建启动项：
- 把模板复制到用户目录：
cp resources/linux/folia-major.desktop ~/.local/share/applications/； - 打开复制后的文件，做两处替换——
__APP_PATH__换成folia-major可执行文件的绝对路径，__ICON_PATH__换成resources/linux/icon.png的绝对路径； - 如果桌面环境要求，把该
.desktop文件标记为可信或可执行。
完整的变量说明与示例路径见 packaging/linux/README-LINUX.txt。
首次启动验收：按顺序确认三件事
启动应用后逐项过一遍：
- 播放任意歌曲，确认歌词以全屏动画形式渲染，而不是小窗滚动；
- 依次登录或切换网易云、QQ 音乐、酷狗、Navidrome 与本地音乐库，确认音源可用；
- 打开应用菜单，确认
Folia（folia-major）启动项存在且能正常拉起程序。
三项都通过，这套安装就算落地了。Wayland 合成器、遥控窗等桌面端细节，可翻 docs/technical.md 与 Docker 部署说明。
黑屏、闪退或透明度异常：改用软件渲染启动
在可执行文件所在目录，用软件渲染模式重启：
FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major
仍不稳定时退回最保守的纯软件渲染：FOLIA_LINUX_GRAPHICS_MODE=software ./folia-major；X11 下提示没有可用 WebGPU 时，可用 FOLIA_LINUX_VULKAN=1 ./folia-major --ozone-platform=x11 手动开启 Vulkan（原生 Wayland 下该变量会被忽略，开了反而会让 GPU 进程崩溃）。
另外两个高频疑问：网盘链接失效或版本过旧时，以 README「直接下载」小节为准并到 Releases 对照版本号；拿不准桌面版还是 Web 版时，日常听歌选桌面版免配置，手机或无桌面环境走 Web 自托管方案。
对号入座，选下载入口：Windows / macOS 转存网盘后双击、Arch 敲一条命令、其他 Linux 替换 .desktop 里两处路径——做完这三步中的任意一步，你就可以开始听第一首全屏歌词动画了。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
