Folia 全屏歌词动画播放器完整安装指南：Windows、macOS、Linux 三条路线一次跑通-育师

Folia 全屏歌词动画播放器完整安装指南：Windows、macOS、Linux 三条路线一次跑通

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

Folia 是一款以全屏沉浸式歌词动画为核心的音乐播放器，支持网易云、酷狗、QQ 音乐、Navidrome 与本地音乐库。本文带你走完 Folia 安装的三条路线：网盘镜像、Linux 便携包、AUR，Windows 与 macOS 约 5 分钟、Linux 约 10 分钟装完即可使用。

遇到 Folia 下载限速、断流或直连困难时，对照下表选一条即可：

路线	一句话定义	适用环境	预计耗时
网盘镜像	官方夸克 / 百度网盘入口，不限速不断流	Windows / macOS（Apple silicon）	约 5 分钟
Releases 直连下载	官方页面取全平台安装包	全平台（直连顺畅时）	约 5 分钟
Linux 便携版	下载 tar.gz 解压即用，无需安装	非 Arch 的 Linux	约 10 分钟
AUR 一条命令安装	自动构建并自动拉取依赖	Arch / Manjaro	约 10 分钟

多数人直接选第 1 条（网盘镜像），下文也按这条路线展开。

⚠️ 只使用 README「快速下载」小节给出的官方网盘入口，勿下载来路不明的第三方转发包。

打开仓库 README.md，定位到「快速下载」小节。你会看到夸克网盘与百度网盘两个官方入口，百度网盘提取码为flia。
用网盘客户端登录，先把安装包转存到自己网盘，再开始下载。你会看到下载按网盘正常速度进行，不限速、不断流。
下载完成后按系统取文件：Windows 拿.exe，macOS（Apple silicon）拿.dmg，双击安装。你会看到安装完成后，开始菜单或 Launchpad 里出现 Folia 图标。

如果网盘里的版本和最新版对不上，属正常镜像延迟，到官方 Releases 页面核对版本号后再继续即可。

# 在解压目录直接运行便携版可执行文件 ./folia-major

执行成功的标志是 Folia 窗口正常弹出。

可选创建桌面启动项：把包内模板复制到用户级应用目录，再把文件里的__APP_PATH__、__ICON_PATH__替换为实际路径，改法见 packaging/linux/README-LINUX.txt。

# 把便携包内的桌面启动项模板复制到用户级应用目录 cp resources/linux/folia-major.desktop ~/.local/share/applications/folia-major.desktop

其中__APP_PATH__换成folia-major的绝对路径，__ICON_PATH__换成resources/linux/icon.png的绝对路径。你会看到应用菜单里出现 Folia 启动项；若桌面环境有要求，把该.desktop文件标记为可信。

未装过 AUR Helper 的，先按 yay 文档装好。你会看到yay --version正常返回版本。
执行安装命令，alsa-lib、gtk3、libxss、nss等依赖自动拉取，定义文件见 packaging/aur/folia-major-bin/PKGBUILD。

# 一条命令安装 folia-major-bin，依赖由 yay 自动处理 yay -S folia-major-bin

执行成功的标志是终端完成构建安装，应用菜单出现 Folia 图标。

✅ 从开始菜单 / 应用菜单启动：窗口弹出且无黑屏，透明度正常 ✅ 搜索并播放任意歌曲：全屏歌词动画与封面加载正常 ✅ AUR 安装：运行下面命令，输出包含folia-major-bin条目，版本号与 AUR 页面一致

# 核对 AUR 安装的包条目与版本号 pacman -Qs folia-major-bin

# swiftshader 为软件渲染，绕过显卡问题 FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major

仍不稳定就改用更保守的FOLIA_LINUX_GRAPHICS_MODE=software。

网盘里的版本和最新版对不上？网盘镜像更新有延迟。以 README「快速下载」入口为准，并到 Releases 页面核对版本号。
AUR 构建卡在拉包？构建时拉取官方 tar.gz 网络较慢。手动放一份同版本folia-major-<版本>-linux-x64.tar.gz进构建源码目录，再执行makepkg -si。

装完先到设置里接入本地音乐库或在线音源，再挑一个喜欢的歌词动画主题；核心能力见 README「核心能力」小节，技术细节查 docs/technical.md 🎵

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考