Folia 安装指南：10分钟让全屏歌词动起来-平芜编程栈

Folia 安装指南：10分钟让全屏歌词动起来

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

歌声一起，歌词不缩在一角，它们铺满整个屏幕，浮动、发光、跟着节拍起舞。这就是 Folia 装好后的样子——一个以全屏沉浸式歌词动画为核心的音乐播放器，接得上本地音乐和 Navidrome、网易云、酷狗等在线平台，还会用 AI 按歌曲内容生成视觉主题。从选路线到点亮，10~20 分钟。

选路线：三问锁定安装方式

先问自己三个问题：系统是什么平台？在这台电脑上用，还是在浏览器里用？网络快，还是得靠网盘？答案对号入座即可。

你的情况	装法	大致耗时	说明
Windows 或 macOS（Apple silicon）桌面	走 README「快速下载」的官方安装包（Releases 页或网盘）	约 10 分钟	桌面版内置前后端运行环境，免装依赖；网盘入口国内更快（百度云提取码`flia`），但只提供这两个平台的正式版安装包
Arch Linux	一条命令走 AUR：`yay -S folia-major-bin`	约 20 分钟	自动拉取 Linux 便携包装到`/opt/folia-major`，构建脚本在`packaging/aur/folia-major-bin/PKGBUILD`；习惯 paru 的把 yay 换成 paru
其他 Linux 发行版，不想折腾依赖	Flatpak，包名`folia-major`	视网络而定	社区第三方维护
服务器 / NAS，想在浏览器里用	Docker Compose 全栈部署 Web 版	视环境而定	详见 deploy/docker/README.md

Arch 装完可以用pacman -Qs folia-major查到folia-major-bin条目。Linux 用户装前顺手在终端敲echo $XDG_SESSION_TYPE，输出x11或wayland都能跑。

主路线实操：桌面版三关点亮

关卡 1：拿到文件打开仓库 README.md 的「快速下载」小节，两个入口：GitHub Releases（全平台安装包）和网盘。按系统挑包——Windows 选.exe，macOS 选.dmg（Apple silicon），Linux 选folia-major-<版本>-linux-x64.tar.gz，版本号以 Releases 页最新条目为准。安装包几百 MB，磁盘留 1 GB 空余比较稳妥。预期看到：文件下载完整、没有中断，版本号和你在 Releases 页挑的一致。

关卡 2：放到正确位置Windows / macOS 双击安装包按提示装完即可；Linux 把压缩包解压到一个固定目录，比如~/Apps/Folia。预期看到：解压后的目录里并排放着folia-major可执行文件和resources/资源目录——应用就是从这里跑起来的。

关卡 3：第一次点亮Windows 从开始菜单、macOS 从 Launchpad 点开 Folia 图标；Linux 在终端执行：

cd ~/Apps/Folia ./folia-major

预期看到：应用窗口弹出，主界面直接铺开全屏歌词画面。

可选关卡 4：给 Linux 加个桌面项把解压目录里的模板resources/linux/folia-major.desktop复制到~/.local/share/applications/，再把文件中的__APP_PATH__与__ICON_PATH__占位符替换成实际绝对路径，做法见 packaging/linux/README-LINUX.txt。预期看到：应用菜单里出现 Folia 项，双击能开窗。

装完先玩三个功能

1. 全屏歌词动画（招牌体验）挑一首带逐字歌词的歌播放，歌词会铺满整个屏幕，字随旋律浮动、点亮，效果接近文字 PV。默认样式不合口味时，AI 能根据歌曲内容自动生成配色与背景主题。

2. 登录一个在线账号在登录页选网易云、酷狗或 Navidrome 登录。之后在线搜到的歌曲会自动加载歌词与封面，搜即播。

3. 本地曲库 + 壁纸模式导入本地音乐（MP3、FLAC、M4A、WAV 等），同目录的.lrc歌词文件自动识别，完整说明见 docs/local-library-management.md。桌面党在「选项 → 桌面端」里开壁纸模式，窗口沉到所有窗口之下当桌面歌词——需要 Wayland 合成器支持wlr-layer-shell（让窗口沉到桌面层的协议），GNOME 不支持。

卡住时自查

现象	判断	动手改
Linux 启动黑屏，或透明度、模糊异常	显卡渲染兼容问题	用软件渲染模式启动`FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major`；仍不稳定就换更保守的`FOLIA_LINUX_GRAPHICS_MODE=software`
AUR 构建卡在下载压缩包	Releases 拉取慢	提前备好同版本 tar.gz 放进构建源码目录，再执行`makepkg -si`
网盘版本和最新版对不上	网盘镜像更新有延迟	以 README「快速下载」入口为准，到 Releases 页核对版本号