Folia 歌词动画播放器快速安装完整指南
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器 A multi-platform music player for local files, Navidrome, and online streaming services, featuring stunning animated lyrics.项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
Folia 是一款全屏沉浸式歌词动画播放器，本地曲库、Navidrome 服务器、网易云 / QQ 音乐 / 酷狗等在线音源都能接。路线结论：Windows 与 macOS 走网盘镜像拿安装器，其余 Linux 发行版用便携 tar.gz 解压即跑，Arch Linux 走 AUR 一条命令装，桌面版内置前后端运行环境，不需要额外装任何依赖。
开始之前：前置环境确认
| 确认项 | 要求 |
|---|---|
| 系统 | Windows x64、macOS（Apple silicon）、Linux x64 |
| 包形态 | Windows.exe/ macOS.dmg/ Linuxfolia-major-<版本>-linux-x64.tar.gz（Debian、Ubuntu 可选.deb，Fedora 可选.rpm） |
| 运行环境 | 无。桌面版内置前后端环境，免装 Node.js 等运行库 |
| 渠道限制 | ⚠️ 网盘镜像仅提供 Windows 与 Apple silicon 的正式版安装包，Linux 包一律去 Releases 页面 |
安装主流程
步骤 1｜按系统获取对应安装包
- Windows / macOS：从 README.md「快速下载」小节的夸克网盘或百度云链接下载，百度链接提取码
flia；先转存到网盘再下载，断流可续传。 - 其他 Linux：去 Releases 页面拿与最新版同版本的
folia-major-<版本>-linux-x64.tar.gz，放到一个不会被系统清理的固定目录。 - Arch Linux：无需手动下载，AUR 已有
folia-major-bin包，构建逻辑见 packaging/aur/folia-major-bin/PKGBUILD。
步骤 2｜安装并首次启动
Windows：双击 exe 完成安装
双击.exe安装器按提示装完即可，全程无需装运行库。看到开始菜单出现 Folia 图标、双击后进入全屏歌词动画主界面，即算跑通。
macOS：拖入 Applications 启动
双击.dmg镜像，把 Folia 图标拖进Applications。看到 Launchpad 出现 Folia 图标并进入主界面，即算跑通。
Linux：解压便携包直接运行
进入解压目录后直接运行可执行文件：
tar -xzf folia-major-<版本>-linux-x64.tar.gz cd folia-major-<版本>-linux-x64 ./folia-major看到弹出带歌词的主窗口即算跑通。
Arch Linux：AUR helper 一条命令装
没有 AUR helper 先装一个（yay 或 paru），然后：
yay -S folia-major-binalsa-lib、gtk3、nss等依赖自动处理。装完执行pacman -Qs folia-major能看到folia-major-bin条目，版本号与 AUR 页面一致，即算成功。
步骤 3｜（可选）给 Linux 创建桌面启动项
把包内桌面模板复制到用户级应用目录：
cp resources/linux/folia-major.desktop ~/.local/share/applications/然后把文件里的__APP_PATH__与__ICON_PATH__两个占位符替换成可执行文件和resources/linux/icon.png的绝对路径，完整示例见 packaging/linux/README-LINUX.txt。看到应用菜单里出现 Folia 图标即算完成。
遇到问题
Q：Linux 启动后黑屏、透明度或模糊异常，甚至 GPU 崩溃？A：多为显卡渲染兼容问题，切到 swiftshader 软件渲染即可绕过：
FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major仍不稳定再改成FOLIA_LINUX_GRAPHICS_MODE=software；想恢复系统图形路径用FOLIA_LINUX_GRAPHICS_MODE=system。
Q：Releases 页面下载慢、反复断流？A：国内网络直连不稳定。Windows / macOS 改走网盘镜像（夸克 / 百度云，百度提取码flia）；Linux 包走更快的下载渠道拿同版本 tar.gz；AUR 构建卡住时，提前把同版本文件放进构建源码目录再执行makepkg -si即可。
Q：网盘里的包版本和最新 release 对不上？A：镜像同步有延迟。以 README.md「快速下载」小节与 Releases 页面的版本号为准，别以网盘里的旧文件名为准。
Q：X11 下智能动感模式提示没有可用的 WebGPU？A：手动开启 Vulkan：FOLIA_LINUX_VULKAN=1 ./folia-major --ozone-platform=x11。该变量只在 X11（含 XWayland）下生效，原生 Wayland 下会被忽略。
装完之后的下一步
接上音源库是体验歌词动画的前提：导入本地音频文件、连接 Navidrome 服务器，具体导入、重扫与在线歌词匹配的用法见 docs/local-library-management.md。
进阶两项：在「选项 → 桌面端」开启壁纸模式，让窗口沉到桌面之下当歌词壁纸（Wayland 需合成器支持wlr-layer-shell，GNOME 不支持）；桌面端 Wayland / Hyprland 遥控窗、更新通道等细节见 docs/technical.md。
现在打开 Folia，导入一份本地曲库或填入 Navidrome 地址，挑一首歌进全屏歌词动画。
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器 A multi-platform music player for local files, Navidrome, and online streaming services, featuring stunning animated lyrics.项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
)
