Folia 歌词动画音乐播放器完整安装教程：Windows、macOS、Linux 全流程-开发者社区

Folia 歌词动画音乐播放器完整安装教程：Windows、macOS、Linux 全流程

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

Folia 是一款把歌词渲染成全屏动画的音乐播放器，支持接入网易云、QQ 音乐、酷狗、Navidrome，也能导入本地音乐库。本安装教程覆盖三大系统的下载、安装与排障全流程，第一次使用的用户跟着做，几分钟就能装完。

装之前先确认

动手下载前，先对照自己的情况：

Windows 或 Mac：走安装包路线。桌面版内置前后端运行环境，无需 Node.js，也无需额外依赖，装完即用。
Arch / Manjaro：有 AUR 包folia-major-bin，一条命令完成。
Debian / Ubuntu / Fedora 及其他发行版：拿.deb、.rpm或linux-x64便携版 tar.gz，解压后手动建桌面启动项。
如果国内直连 GitHub Releases 页面速度慢：有网盘镜像渠道，见下一节。

按系统选对安装包

你的系统	该拿的包
Windows	`.exe`安装包
macOS（Apple silicon）	`.dmg`安装包，选对应架构版本
macOS（Intel）	`.dmg`安装包
Debian / Ubuntu	`.deb`包
Fedora / RHEL 系	`.rpm`包
其他 Linux 发行版	`linux-x64`便携版 tar.gz

正式渠道是项目的 Releases 页面。如果直连下载慢到掉线，改用 README.md「直接下载」一节的夸克网盘或百度镜像（提取码flia）。

网盘取包留意两点：镜像只覆盖 Windows 与 Apple silicon 两个正式版安装包，Intel Mac 和 Linux 都不在网盘里，需要回 Releases 页面；网盘版本会滞后于最新 release，取下来先核对版本号。

安装 Windows 版 .exe 包

拿哪个包：Releases 页面向 Windows 发布的.exe安装包；网盘镜像版本合适时也可以用网盘的。

安装步骤：双击.exe，按安装向导完成即可，全程不依赖任何环境。

装完验证：在开始菜单找到 Folia 并启动，主界面能正常渲染就算成功。

安装 macOS 版 .dmg 包

拿哪个包：Releases 页面的.dmg安装包。Apple silicon 的 Mac 要选对应架构版本；网盘镜像也有这一版，但注意版本滞后。

安装步骤：双击.dmg，把应用拖进应用程序文件夹。

装完验证：在启动台找到 Folia 启动，主界面正常显示即可。

AUR 一行装

拿哪个包：AUR 包folia-major-bin。

安装步骤：yay 或 paru 装好后执行（用 paru 时命令相同）：

yay -S folia-major-bin

这个 AUR 包本质是薄封装：构建时从 Releases 拉取folia-major-<版本>-linux-x64.tar.gz，整体放进/opt/folia-major，再建一个usr/bin/folia-major的链接。当前包版本 0.1.4，依赖清单（alsa-lib、gtk3、libxss、nss）都能在 PKGBUILD 里核对。

装完验证：在终端输入folia-major启动，或在应用菜单里找到它。如果构建长时间卡在下载步骤，不用再等，直接改用下文的便携版手动方式。

安装 Debian 版 .deb 包

拿哪个包：Releases 页面的.deb包。

安装步骤：双击安装，或用系统包管理工具安装。

装完验证：在应用菜单里找到 Folia 启动。

安装 Fedora 版 .rpm 包

拿哪个包：Releases 页面的.rpm包。

安装步骤：双击或用系统包管理工具安装。

装完验证：从应用菜单启动，确认主界面正常。

手动部署 Linux 便携版

这一节覆盖其他发行版和所有不在网盘镜像里的情况。便携版 tar.gz 里就三样东西：folia-major可执行文件、resources/linux/icon.png图标、桌面模板resources/linux/folia-major.desktop。

想让它出现在应用菜单里，按这三步做：

把模板复制到~/.local/share/applications/folia-major.desktop
打开复制出的文件，把__APP_PATH__（指向可执行文件）和__ICON_PATH__（指向图标）两个占位符替换成实际绝对路径
桌面环境若要求，把这个文件标记为可信或可执行

完整示例见 packaging/linux/README-LINUX.txt。

首次启动后怎么验证

安装是否成功，用这三个动作判断：

主界面正常渲染，没有黑屏或透明度异常
导入一个本地音乐目录，或登录网易云、Navidrome 等平台账号
播放一首带逐字歌词的歌，全屏歌词动画正常出现

装不上？按症状对号入座

症状	处理
Linux 启动黑屏、透明度或模糊异常	先换软件渲染：`FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major`
swiftshader 下仍闪烁不稳	再退到最保守的软件渲染：`FOLIA_LINUX_GRAPHICS_MODE=software ./folia-major`
网盘链接失效或版本过旧	以 README.md「直接下载」一节的最新链接为准，并核对版本号
AUR 构建卡在下载步骤	直接改用便携版手动部署
网盘里没有你要的平台包（Intel Mac / Linux）	回 Releases 页面直接取对应平台包