Folia 全屏歌词动画播放器国内下载与安装指南：三条路线约 10 分钟跑起来
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
Folia 是一款以全屏沉浸式歌词动画为核心的开源音乐播放器，支持网易云音乐、酷狗、QQ 音乐、Navidrome 与本地音乐库，还带 AI 主题生成与智能歌词匹配。本文面向想把工具装起来、跑起来的用户，走一遍 Folia 国内下载与安装的三条路线：Windows 和 macOS 走官方网盘镜像，约 5 分钟装完；Linux 用官方便携版或 AUR 一条命令，约 10 分钟。照做完，你能启动播放器、搜到任意歌曲并看到全屏歌词动画。
先判断走哪条 Folia 安装路线：环境对照表
不确定选哪条就先看这张表，关键就两个问题：系统是什么、是不是 Arch。
| 环境 | 推荐路线 | 安装形态 | 预计耗时 |
|---|---|---|---|
| Windows（x64） | 官方网盘镜像 | .exe安装包 | 约 5 分钟 |
| macOS（Apple silicon） | 官方网盘镜像 | .dmg镜像 | 约 5 分钟 |
| 非 Arch 的 Linux（Ubuntu / Debian / Fedora 等） | 官方 Linux 便携版 | .tar.gz解压即用 | 约 10 分钟 |
| Arch Linux | AURfolia-major-bin | AUR Helper 一条命令 | 约 10 分钟 |
⚠️ 只使用 README.md「快速下载」小节列出的官方网盘入口，不要下载来路不明的第三方转发包。
Windows 与 macOS：网盘镜像完成 Folia 安装
适用环境
Windows x64 与 macOS（Apple silicon）。官方网盘镜像只承载这两个平台的正式版安装包，对多数用户来说正好够用。
操作步骤
- 打开 README.md，定位「快速下载」小节，里面有夸克网盘与百度网盘两个官方入口，百度网盘提取码为
flia。 - 用网盘客户端登录后，先把安装包转存到自己的网盘再开始下载，中转更稳，不容易断流；速度按网盘正常水平走，不限速。
- 按系统取文件：Windows 拿
.exe安装包，macOS 拿.dmg镜像，双击后按提示装完即可。
装完后的可验证结果
开始菜单（Windows）或 Launchpad（macOS）里会出现 Folia 图标。点击启动后，主界面正常出现，搜索框与封面轮播都可见，就说明这一环节通了。
非 Arch Linux：Folia 便携版安装步骤（解压即用）
适用环境
Arch 以外的 Linux 发行版：Ubuntu、Debian、Fedora 等。不需要 root、不装任何依赖，解压即用。
操作步骤
- 前往官方 Releases 页面（README.md「获取方式」小节有入口）下载
folia-major-<版本>-linux-x64.tar.gz，版本号以页面显示为准。 - 解压到任意固定目录。便携包内含
folia-major可执行文件、resources/linux/icon.png图标和桌面启动项模板。
# 解压 Folia Linux 便携版，文件名换成你实际下载的版本号 tar -xzf folia-major-0.1.4-linux-x64.tar.gz- 双击解压目录里的
folia-major可执行文件启动。 - （可选）创建桌面启动项：把模板复制到用户级应用目录，再把文件里的
__APP_PATH__与__ICON_PATH__两个占位符替换为实际路径。
# 把桌面启动项模板复制到用户级应用目录 cp resources/linux/folia-major.desktop ~/.local/share/applications/folia-major.desktop替换写法在 packaging/linux/README-LINUX.txt 里给了完整示例；如果桌面环境有要求，把复制后的.desktop标记为可信或可执行。
装完后的可验证结果
在解压目录执行./folia-major，Folia 窗口正常弹出、画面无黑屏；应用菜单里能找到 Folia 启动项。
Arch Linux：AUR 一条命令安装 folia-major-bin
适用环境
Arch Linux。构建交给 yay 这类 AUR Helper 自动完成，不用手工处理依赖。
操作步骤
- 没装过 AUR Helper 的，先按 yay 文档装好；
yay --version能正常返回版本号即代表就绪。 - 执行安装命令：
# 一条命令安装 folia-major-bin，依赖由 yay 自动处理 yay -S folia-major-bin构建过程会自动拉取官方 Linux 便携包，并装好alsa-lib、gtk3、libxss、nss等运行时依赖，完整定义见 packaging/aur/folia-major-bin/PKGBUILD（其中记录的版本号为 0.1.4）。
装完后的可验证结果
终端跑完构建安装后，应用菜单出现 Folia。再执行下面命令核对包条目：
# 核对 AUR 安装的包条目与版本号 pacman -Qs folia-major-bin输出包含folia-major-bin条目、且版本号与 AUR 页面一致，即安装成功。
30 秒验收清单：确认 Folia 跑起来了
无论走哪条路线，都过一遍这份清单：
- 从开始菜单 / 应用菜单启动：窗口弹出、无黑屏、透明度正常
- 搜索并播放任意歌曲：全屏歌词动画与封面加载正常
- AUR 安装：
pacman -Qs folia-major-bin输出带版本号的条目 - 便携版：在解压目录执行
./folia-major，窗口正常弹出
排障速查：黑屏、版本对不上与构建卡住
| 现象 | 原因 | 处置 |
|---|---|---|
| 启动后黑屏、模糊、透明度异常 | GPU 渲染兼容问题 | 用软件渲染模式启动：FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major；仍不稳定再改software |
| 网盘里的版本和最新版对不上 | 网盘镜像存在更新延迟 | 以官方「快速下载」入口为准，并在官方 Releases 页面核对版本号后再继续 |
| AUR 构建卡在拉包 | 构建时拉取官方tar.gz网速慢 | 手动放一份同版本folia-major-<版本>-linux-x64.tar.gz进构建源码目录，再执行makepkg -si |
| 桌面启动项不出现 | .desktop文件未被标记可信 | 将复制后的.desktop标记为可信或可执行，写法见 packaging/linux/README-LINUX.txt |
Linux 图形变量还有更多组合（如 X11 下手动开 Vulkan），细节查 packaging/linux/README-LINUX.txt 与 docs/technical.md。
装完之后：接入音源与挑选全屏歌词主题
装好后的第一件事是接音源：进入设置，选本地音乐库，或登录网易云 / QQ / 酷狗等在线音源。本地曲库的导入、匹配与重扫说明见 docs/local-library-management.md；部署、环境变量与 Stage API 等技术细节见 docs/technical.md。
歌曲播放起来后，挑一个喜欢的全屏歌词主题。每种动画模式的排版氛围与可调参数都不同，能让全屏歌词拥有接近文字 PV 的视觉效果，同时自动适配窗口尺寸。
桌面版用户还可以尝试 Folium 模组系统：在「设置 → 模组 → 模组系统」中开启后，即可加装新的歌词动画、背景与播放页图层；仓库 mods/ 目录里有多个官方示范模组可以直接参考。
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考