Folia 安装指南：全屏歌词动画播放器，10 分钟装好并启动-育师

Folia 安装指南：全屏歌词动画播放器，10 分钟装好并启动

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

这篇教程面向 Folia 音乐播放器：本地曲库、网易云音乐、酷狗、Navidrome 等在线音源都能播，最特别的是把歌词做成全屏动画——逐字歌词在屏幕上流动，背景主题由 AI 按歌曲情绪生成，效果接近文字 MV。跟着做完，10 分钟内你就能看到全屏歌词在自己电脑上动起来，全程不需要配置任何开发环境，桌面版安装包自带运行环境。

先选路线

先定路线，再往下看步骤：

路线	适用环境	大致耗时	一句话差异
桌面安装包（推荐）	Windows / macOS / Linux	约 10 分钟	运行时内置，装完即用
网盘镜像	Windows / macOS（Apple silicon）	约 10 分钟	国内网络更快，仅这两个平台
AUR 一条命令	Arch Linux	约 20 分钟	自动拉取 Linux 便携包并装好
Flatpak	其他 Linux 发行版	视网络而定	社区第三方维护的包
Web / Docker	服务器、NAS	视环境而定	浏览器访问，Compose 全栈部署

Folia 主线安装：从安装包到第一次启动

Folia 下载：按系统挑安装包

打开仓库README.md的「快速下载」小节：GitHub Releases 列有全平台安装包；国内网络慢就用同小节给出的夸克网盘或百度网盘入口（百度提取码flia，只提供 Windows 与 Apple silicon 的版本）。

按系统选文件：Windows 是Folia-Setup-<版本>.exe，macOS 是.dmg，Linux 是folia-major-<版本>-linux-x64.tar.gz（另有 deb、rpm 可选），版本号以 Releases 页最新条目为准。

完成标志：下载完整未中断，文件名里的版本号与最新发布一致。

Folia 安装：装一下或解压

Windows、macOS：双击安装包，按向导点完即可，一两分钟。
Linux：把压缩包解压到固定目录，例如~/Apps/Folia，确认folia-major可执行文件与resources/位于同一目录。

完成标志：目录里同时看得到folia-major可执行文件和resources/资源目录。

Folia 启动：打开第一个窗口

Windows 从开始菜单启动，macOS 从 Launchpad 启动；Linux 在终端执行：

cd ~/Apps/Folia ./folia-major

Arch 用户可跳过上面三步，直接跑yay -S folia-major-bin（用 paru 的把 yay 换掉），随后pacman -Qs folia-major应能看到folia-major-bin。

想在 Linux 菜单里常驻的：把resources/linux/folia-major.desktop复制到~/.local/share/applications/，再把其中的__APP_PATH__与__ICON_PATH__占位符替换成实际绝对路径，方法见 packaging/linux/README-LINUX.txt。

完成标志：应用窗口弹出并出现全屏歌词界面，到这里安装就算成了。

平台差异速记

平台	下载产物	安装与启动	备注
Windows	`Folia-Setup-<版本>.exe`	双击安装，开始菜单启动	安装时可更换安装目录
macOS（Apple silicon / Intel）	`.dmg`	双击拖入 Applications，Launchpad 启动	网盘镜像仅提供 Apple silicon 版
Linux	`folia-major-<版本>-linux-x64.tar.gz`	解压后运行`./folia-major`	渲染异常可切软件渲染，见下节
Web / Docker	`compose.yaml`加`.env`两个文件	`docker compose up -d --wait`	默认 Web 端口`18080`，细节见 deploy/docker/README.md

装好后的第一次体验

装完按顺序做三件事，Folia 就算完全能用：

导入本地曲库：在应用内选择音乐目录导入，支持 MP3、FLAC、M4A、WAV 等格式，同目录同名的.lrc等歌词文件会被自动识别。预期：曲库页面出现歌曲列表。更多操作见 docs/local-library-management.md
登录在线账号：在登录页选网易云、酷狗或 Navidrome 完成登录。预期：搜索一首歌能播放，歌词与封面自动加载。

触发全屏歌词动画：放一首带逐字歌词的歌，看歌词在全屏逐字流动；应用还会按歌曲内容与情绪生成一套背景主题。

装不上或不对劲

症状	原因	处理
Linux 启动黑屏、透明度或模糊异常	显卡渲染兼容问题	`FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major`
换 swiftshader 后仍不稳定	图形路径问题更深	改用`FOLIA_LINUX_GRAPHICS_MODE=software`走最保守的软件渲染
AUR 构建卡在下载压缩包	Releases 拉取慢	把同版本 tar.gz 提前放进构建源码目录，再`makepkg -si`
网盘版本和最新版对不上	镜像更新有延迟	回到 README「快速下载」入口，以 Releases 页版本号核对