Folia 歌词动画播放器下载安装指南：3 步快速装好并跑起来- 惊觉

Folia 歌词动画播放器下载安装指南：3 步快速装好并跑起来

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

Folia（folia-major）是一个把歌词渲染成全屏动画的歌词动画播放器，支持网易云、QQ 音乐、酷狗、Navidrome 和本地音乐库。如果你正卡在「Releases 下不动」「网盘里找不到自己要的平台」「Linux 解压完不知道往哪放」这几个问题上，这篇下载安装教程就是照着你的处境写的。

先说好结论：Windows 和 Apple silicon Mac 的国内用户，优先走官方网盘镜像；其他所有情况（Intel Mac、全部 Linux、镜像里没有的包），直接去 Releases 页面拿对应平台的包。桌面版是 Electron 打包的完整应用，内置运行环境，装完就能用，不需要你本地装 Node.js 或任何依赖。

第一幕选包：按系统和架构对号入座

下载前最容易犯的错误是「先看链接再想自己需要什么」。先定坐标：

你的环境	该拿的包	文件长这样
Windows x64	安装程序（网盘镜像也有）	`Folia-Setup-<版本>.exe`
macOS Apple silicon（M1/M2/M3…）	安装镜像（网盘镜像也有）	`Folia-<版本>-arm64.dmg`
macOS Intel	安装镜像（仅 Releases 有）	`Folia-<版本>-x64.dmg`
Debian / Ubuntu / Fedora 等 Linux x86_64	便携压缩包（仅 Releases 有）	`folia-major-<版本>-linux-x64.tar.gz`
Arch Linux / Arch 系	AUR 包 `folia-major-bin`，或直接便携包	—
手机、服务器、无桌面环境	Web 版（需自行部署，可装成 PWA）	—

三个提醒：

Linux 的便携包解压后就是全部：一个 folia-major 可执行文件加一个 resources/ 目录（里面有图标和桌面启动项模板），没有安装过程，所以「装在哪个目录」由你定。
桌面版和 Web 版是两条独立的版本线，版本号不一样很正常，各取各的最新版即可。
如果你用的是 Navidrome 自建源，装好后在 Folia 里填服务器地址就能用，拿包方式和上面一样：

第二幕拿包：按你的网络处境走

直连顺畅：去 Releases 页面拿

打开项目的 Releases 页面，认准最新的 release
按上一节表格找到你平台的文件名，点击下载
下载完成后对一眼版本号，和本页最新 release 一致再开始装

这条路线拿到的是全平台、最新版本的包，是最省心的默认选择。

国内网络：走官方网盘镜像

直连 GitHub Releases 慢、断、转圈，就换网盘。README 的「快速下载 / 直接下载」一节挂着夸克和百度网盘两个官方镜像（百度提取码是 flia）。

打开 README.md，找到网盘镜像链接
Windows 用户拿 .exe，Apple silicon Mac 用户拿 -arm64.dmg
下之前对比一下镜像里的版本号和 Releases 最新 release，有落差就不值得等
本地音乐库目录想自己托管的话，也可以看看 deploy/docker/README.md 的 Docker 方案

⚠️ 踩坑提醒：网盘镜像只有 Windows 和 Apple silicon 两个正式版安装包。Intel Mac、Linux 全部不在其中，别在网盘里翻，直接回 Releases 拿。

手动兜底：Linux 便携包部署

Debian、Ubuntu、Fedora 这些非 Arch 发行版，拿到的就是这个 tar.gz：

下载 folia-major-<版本>-linux-x64.tar.gz
解压到一个固定目录（比如 ~/Apps/Folia/），以后升级也放这儿
把包内 resources/linux/folia-major.desktop 模板复制到 ~/.local/share/applications/
打开复制出来的文件，把 __APP_PATH__ 和 __ICON_PATH__ 两处占位符替换成可执行文件和图标的实际绝对路径
按桌面环境要求把 .desktop 文件标记为可信，应用菜单里就会出现 Folia

模板怎么写、路径示例长什么样，仓库里 packaging/linux/README-LINUX.txt 有完整说明。

Arch 用户的一条命令

确认 yay 或 paru 可用
执行下面这条（它做的事：从 Releases 拉最新 Linux 包、装到 /opt/folia-major、建好桌面启动项，依赖清单 alsa-lib、gtk3、libxss、nss 一并处理）：

yay -S folia-major-bin

应用菜单里直接启动即可

⚠️ 踩坑提醒：AUR 包本质仍是去 Releases 下载 tar.gz，所以下载卡住等于直连没救，别干等，改走上面的便携包手动部署。另外 AUR 包版本（当前 PKGBUILD 是 0.1.4）可能落后于 Releases 最新版，在意版本的话直接拿便携包。

第三幕跑起来：启动、确认、急救

启动并确认装对了

Windows：双击 .exe 按向导装完，开始菜单启动 Folia
macOS：把 Folia.app 从 dmg 窗口拖进「应用程序」，再启动（别在挂载盘里直接双击）
Linux：在解压目录执行 ./folia-major，或点应用菜单里的 Folia
确认三步：首页正常渲染 → 搜索一首你熟悉的歌 → 播放，看歌词是不是以动画形式铺满全屏

装对之后的日常：导入本地歌曲会自动匹配在线歌词和封面，本地库的完整管理方法见仓库文档；Navidrome、QQ 音乐等在线源的连接设置都在「设置」里。

Linux 起不来：先换渲染模式

启动黑屏、透明度/模糊异常、GPU 崩溃，都是图形栈不配合，不用重装，换启动方式：

FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major

它在做什么：强制应用用内置的软件光栅化渲染，绕开你自己的 GPU 驱动问题。

翻车急救速查

症状	解法
macOS 提示「Folia.app 已损坏，无法打开」	按住 Control 点应用选「打开」；或到「隐私与安全性」点「仍要打开」；再不行执行 `xattr -dr com.apple.quarantine /Applications/Folia.app`（移除系统打的下载隔离标记）
Linux 启动黑屏、透明度异常	用 `FOLIA_LINUX_GRAPHICS_MODE=swiftshader` 启动
swiftshader 仍不稳定	换成更保守的 `FOLIA_LINUX_GRAPHICS_MODE=software` 启动
网盘链接失效或版本太旧	以 README「直接下载」一节的最新链接为准，再不行回 Releases
AUR 构建卡在下载	放弃等待，改走便携包手动部署
网盘里没有 Intel Mac / Linux 包	正常现象，直接去 Releases 拿对应平台包
想升级 Linux 版	没有自动更新，下载新版 tar.gz 重新解压覆盖即可

Folia 歌词动画播放器下载安装指南：3 步快速装好并跑起来