Folia 安装教程：15 分钟装好全屏歌词动画播放器，Windows、macOS、Linux 全支持
Folia 安装教程：15 分钟装好全屏歌词动画播放器，Windows、macOS、Linux 全支持
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
把歌词铺满整个桌面当壁纸，是不少人的理想听歌场景。Folia 就是一个让歌词变成全屏动画的开源音乐播放器：本地曲库、Navidrome、网易云、酷狗、QQ 音乐都能接进来，歌词、封面自动补齐，还能用 AI 按歌曲情绪生成配色主题。本文是一份 Folia 安装与首次配置指南，桌面版自带完整运行环境，不挑机器配置，跟着走大约 15 分钟，装完你就能管理自己的曲库并播放带逐字歌词的歌。
先看看效果
Folia 的招牌是把歌词做成占满全屏的动画舞台，逐字高亮、排版随主题变化，仓库里备好了「浮名」「云阶」「流光」等多套风格，播放时自动切换逐字渲染。它还能根据歌曲内容生成背景与视觉参数，让每首歌的歌词画面都不一样。
桌面党还有壁纸模式：把整个窗口沉到所有窗口之下，歌词直接铺在桌面上，切到别的应用也不会消失（需要 Wayland 合成器支持wlr-layer-shell，GNOME 不支持）。
动手前的准备检查
Folia 安装之前，先把下面四项过一遍，能省掉大部分返工：
| 检查维度 | 要求 | 自查方式 |
|---|---|---|
| 操作系统 | Windows、macOS、Linux 桌面均可 | 系统设置里确认系统与架构 |
| 网络 | 能打开仓库 Releases 页即可；国内网络慢可走网盘入口 | 浏览器访问 README「快速下载」中的入口 |
| 磁盘空间 | 安装包数百 MB，建议预留 1 GB 以上 | 查看目标分区可用容量 |
| Linux 桌面环境 | X11 或 Wayland 均可 | 终端执行echo $XDG_SESSION_TYPE，输出x11或wayland都算通过 |
安装方式怎么选
Folia 安装路线一共有五条，先对照下表做选择，后文只展开第一条（也是覆盖系统最广的一条）：
| 路线 | 支持的系统 | 大约耗时 | 特点 |
|---|---|---|---|
| 官方 Releases 下载桌面包 | Windows / macOS / Linux | 10~15 分钟 | 内置前后端运行环境，即装即用，本文主推 |
| 网盘下载 | 仅 Windows 与 macOS（Apple silicon） | 10 分钟 | 国内网络更快，适合 Releases 下载慢的情况 |
| AUR | 仅 Arch Linux | 20 分钟 | 一条命令自动拉包并安装 |
| Flatpak | 其他 Linux 发行版 | 视网络而定 | 社区第三方维护 |
| Web 部署 | 服务器 / NAS | 视环境而定 | 浏览器访问，支持 Docker Compose 全栈 |
主流路线分步操作
第 1 步：找到下载入口
做什么：打开仓库 README，定位「快速下载」小节，里面同时给出 GitHub Releases 入口和网盘入口。
怎么判断做对了：入口能打开，页面列出了 Windows、macOS、Linux 各平台的安装包文件。
没成功去哪里查：README 同一小节里网盘入口的提取码是flia，两条入口指向的是同一批版本，版本号以 Releases 页最新条目为准。
第 2 步：按系统挑选安装包
做什么：Windows 选.exe，macOS 选 Apple silicon 对应的.dmg，Linux 选形如folia-major-<版本号>-linux-x64.tar.gz的压缩包。
怎么判断做对了：下载文件完整，大小与 Releases 页标注一致，没有中断重传。
没成功去哪里查：国内网络下载慢就改用「快速下载」里的网盘入口；它只提供 Windows 与 Apple silicon 两个平台的正式包，Linux 用户仍需走 Releases。
第 3 步：安装或解压到固定目录
做什么：Windows 与 macOS 双击安装包按向导装完即可；Linux 把压缩包解压到一个不会随意移动的目录，比如~/Apps/Folia。
怎么判断做对了：Linux 目录里能同时看到folia-major可执行文件和resources/资源目录，两者缺一不可。
没成功去哪里查：目录结构不完整说明解压被中断，重新下载解压；路径规则见 packaging/linux/README-LINUX.txt。
第 4 步：启动应用
做什么：Windows 从开始菜单、macOS 从 Launchpad 找到 Folia 图标启动；Linux 在终端执行：
cd ~/Apps/Folia ./folia-major怎么判断做对了：应用窗口弹出，出现全屏歌词界面。
没成功去哪里查：Linux 出现黑屏或透明度异常时，换软件渲染模式启动，命令见下方「常见卡点与处理办法」。
第 5 步：可选，创建 Linux 桌面启动项
做什么：把解压目录里的模板resources/linux/folia-major.desktop复制到~/.local/share/applications/，再把文件里的__APP_PATH__与__ICON_PATH__两个占位符替换为实际绝对路径。
怎么判断做对了：应用菜单里出现 Folia 一项，双击能正常开窗。
没成功去哪里查：替换方法有完整示例，见 packaging/linux/README-LINUX.txt；部分桌面环境还需要把该.desktop文件标记为可信。
其他系统的快捷通道
网盘安装（Windows / macOS Apple silicon）：适合国内网络，直接下载对应系统安装包双击安装，入口同样在 README「快速下载」小节。
Arch Linux（AUR 一条命令）：
yay -S folia-major-bin装完执行pacman -Qs folia-major，能看到folia-major-bin条目即成功；习惯用 paru 的把命令里的 yay 换成 paru。脚本会自动拉取 Linux 便携包并装到/opt/folia-major，构建逻辑见 packaging/aur/folia-major-bin/PKGBUILD。
Flatpak（其他 Linux 发行版）：社区第三方维护，包名folia-major，从 Flatpak 商店或flatpak命令安装即可。
Web 部署（服务器 / NAS）：支持 Docker Compose 全栈，默认只对外暴露 Web 网关与 Sync Server 两个端口，完整步骤与端口说明见 deploy/docker/README.md。
首次启动配置清单
- 导入本地曲库。进入本地音乐区域选择「导入文件夹」，支持 MP3、FLAC、M4A、WAV、OGG、Opus、AAC，同目录的
.lrc、.vtt、.ttml等歌词文件会被自动识别。预期效果：曲库页列出全部歌曲，且本地歌能自动匹配到在线歌词与封面。
登录在线音乐账号。在登录页选择网易云、酷狗或 Navidrome 完成登录。预期效果：在线搜索到的歌曲能直接播放，右侧同步显示歌词与封面，说明见 docs/local-library-management.md。
播一首带逐字歌词的歌，体验全屏歌词动画。预期效果：歌词逐字高亮，动画随主题排版变化。
（桌面党可选）在「选项 → 桌面端」开启壁纸模式。预期效果：切到其他应用时桌面仍显示歌词；该模式切换后应用会自动重启。
常见卡点与处理办法
| 现象 | 可能原因 | 处理办法 |
|---|---|---|
| Linux 启动黑屏、透明度或模糊异常 | 显卡渲染兼容问题 ⚠️ | 先试软件渲染：FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major；仍不稳定改用FOLIA_LINUX_GRAPHICS_MODE=software ./folia-major |
| AUR 构建卡在下载压缩包 | Releases 拉取速度慢 | 提前下载同版本 tar.gz 放进构建源码目录，再执行makepkg -si |
| 网盘版本比最新版旧 | 网盘镜像更新有延迟 | 到 README「快速下载」入口核对版本号，以 Releases 页为准 |
| 启动报错或界面空白（Linux） | 可执行文件与resources/不在同一目录 | 确认便携包目录结构完整，详见 packaging/linux/README-LINUX.txt |
装完并配好曲库后，日常从应用菜单启动即可；之后有新版时走同一条路线重装，版本号一律以仓库 README 与 Releases 页为准。下一步建议把壁纸模式试起来，让歌词真正铺满你的桌面 🎵
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考