Folia 歌词动画播放器国内网络 3 分钟装好：网盘镜像与 AUR 完整安装指南-开发者社区

Folia 歌词动画播放器国内网络 3 分钟装好：网盘镜像与 AUR 完整安装指南

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

官方下载源在国内网络经常限速中断，Arch 用户的 AUR 包也没人讲过怎么装。本文给 Folia 歌词动画播放器一套照做即成的安装路径：Windows / macOS 走网盘镜像，Arch 走 AUR 一条命令，其他 Linux 用便携版兜底，全程 3 分钟装完验收。

前提：只需夸克网盘或百度网盘客户端，没装就先装一个。

打开 README.md，找到「快速下载」一节的网盘入口——应看到夸克网盘与百度云两条入口（百度云提取码flia）。
存到自己的网盘后下载对应平台的包：Windows 选.exe，macOS 选 Apple silicon 版.dmg——下载完成，文件大小与页面标注一致。
双击安装包按提示点完——安装完成，桌面多出 Folia 图标，点击可打开主窗口，桌面版已内置前后端，无需再配后端。

💡 网盘镜像滞后一个版本，且只提供 Windows 与 Apple silicon 正式版，选包前对照 Releases 页面版本号，别拿错旧包；Wayland / 遥控窗等桌面端细节查 docs/technical.md。

前提：已装 AUR 助手（yay或paru），装完执行yay --version输出版本号即就绪。

⚡ 构建卡在 Releases 下载这一步：手动下载同版本folia-major-<版本>-linux-x64.tar.gz放进 AUR 构建源码目录，再执行makepkg -si跳过慢速下载。

前提：从 Releases 页面拿到folia-major-<版本>-linux-x64.tar.gz，国内网络慢就改用网盘镜像里的包。

解压到应用目录（如~/Apps/Folia）——目录里应看到folia-major可执行文件与resources/目录。
把resources/linux/folia-major.desktop复制到~/.local/share/applications/，将__APP_PATH__、__ICON_PATH__替换为实际绝对路径——应用菜单出现 Folia 启动项。
双击启动项运行——主窗口正常打开、不黑屏，便携版安装完成。

💡 黑屏、透明度异常或闪退时，切软件渲染兜底，变量用法见 packaging/linux/README-LINUX.txt。

现象	原因	解法
Linux 启动黑屏、透明度异常或闪退	GPU 渲染不兼容	`FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major`，仍不稳再换`software`
AUR 构建卡在下载步骤	Releases 拉取慢	手动下载同版本压缩包进构建目录，执行`makepkg -si`
网盘版本对不上最新版	镜像滞后一个版本	网盘只提供 Windows 与 Apple silicon 正式版，去 Releases 页面拿最新包
便携版装完菜单没有启动项	`.desktop`路径占位符未替换	检查`__APP_PATH__`是否为可执行文件绝对路径，并标记文件为可信