Folia 安装指南：十分钟跑起全屏歌词动画播放器-二趣网

Folia 安装指南：十分钟跑起全屏歌词动画播放器

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

Folia 是一款把歌词渲染成跟随节拍的全屏动画的播放器，网易云、酷狗、Navidrome 等在线音源和本地曲库都能播放。桌面端用 Electron 封装、运行时一并打包，装完点开即用，不用单独搭环境。网络顺畅的话，全程大约 10 分钟。

动手前确认

选路线之前先把三件事过一遍，免得装到一半才发现走错了：

确认系统与芯片。官方网盘镜像只收录 Windows 与 Apple silicon（M 系芯片）的安装包；Intel 芯片的 Mac 或其他系统，一律去官方 Releases 取包。
想清楚要碰多少命令行。路线 A 完全不用打开终端；路线 B 敲一行命令；路线 C 主要是拷贝文件、替换文本，不涉及深度配置。
备好账号。打算播放在线音源就准备好对应平台的账号；只走本地曲库的话，有一个存着音乐的目录即可。

怎么定路线

按顺序回答三个问题，路就清楚了：

系统是 Windows 或 M 系 Mac，且不想碰终端？走路线 A。
在用 Arch 或 EndeavourOS，装过yay或paru？走路线 B。
是 Ubuntu、Debian、Fedora 等发行版，或者想让 NAS 跑一个浏览器能打开的 Web 版？走路线 C。

💡 三条路线装出来的是同一个 Folia，仅交付形态有差异，功能上没有出入。

分路线安装

路线 A｜Windows 与 Apple silicon Mac 的安装包

先决条件

Windows 系统，或搭载 Apple silicon 的 Mac；能用浏览器或网盘客户端下载文件。

操作

打开 README.md，进入「快速下载」一节，里面给出官方夸克与百度网盘两个入口（百度提取码flia）。
从网盘取对应平台安装包：Windows 是.exe，macOS 是.dmg。
双击安装包，按向导走完全程；Mac 上先从 dmg 把Folia.app拖进Applications再启动。

⚠️ 安装包只从 README 里的官方网盘入口下载，来路不明的再打包文件不要使用。

完成标志

Windows 开始菜单或 macOS 应用程序目录里出现 Folia 快捷方式，双击能进主界面并正常搜索播放。

路线 B｜Arch 系发行版用 AUR 一行装好

先决条件

Arch 或 EndeavourOS，已装 AUR 助手yay或paru；用paru的话，把下面命令里的yay换成paru。

操作

yay -S folia-major-bin

助手会先从 AUR 拉取folia-major-bin源码，再取回官方 Releases 的同版本 Linux 压缩包，alsa-lib、gtk3、libxss、nss等系统依赖也会自动装好。

⚡ Releases 下载慢时，先把同版本folia-major-<版本>-linux-x64.tar.gz手动存进 AUR 源码目录，再执行下面这条，在本地完成构建与依赖安装：

makepkg -si

完成标志

可执行文件落在/opt/folia-major，终端里敲folia-major可以直接启动，应用菜单也多出一个同名入口。依赖清单与安装位置写在 packaging/aur/folia-major-bin/PKGBUILD（AUR 包定义）。

路线 C｜通用 Linux 便携版与 Docker Web 自托管

先决条件

便携版：Ubuntu、Debian、Fedora 等发行版，任意能解压的目录。
自托管 Web 版：装好 Docker 的服务器或 NAS。

操作 · 便携版

从官方 Releases 取同版本 Linux 压缩包，解压到任意目录。除folia-major可执行文件外，包内还有resources/linux/目录，装着应用图标和桌面启动项模板。
直接启动：

./folia-major

想建桌面启动项的话，把resources/linux/folia-major.desktop拷进~/.local/share/applications/，将其中__APP_PATH__与__ICON_PATH__两个占位符换成可执行文件和图标所在的绝对路径，并按桌面环境的提示标记为可信。完整说明见 packaging/linux/README-LINUX.txt（Linux 便携版说明）。

操作 · Web 自托管

按 deploy/docker/README.md（Docker Compose 全栈部署文档）在服务器或 NAS 上把 Web 版起起来，用浏览器访问即可。

💡 访问本地音乐曲库要求可信 HTTPS 环境，反向代理与证书的配置细节写在部署文档里。

完成标志

便携版启动后与路线 A 的主界面一致；自托管 Web 版在浏览器里能播在线音源与本地曲库；手机上用 Chrome for Android 或 iOS Safari 添加到主屏幕，即成为 PWA 应用。

验收

装完后对照下面四条逐项打勾，全部通过才算真正装好：

Folia 出现在应用菜单或安装快捷方式中，双击后主界面完整加载。
任一在线音源登录成功，或本地文件夹导入曲库——导入只记录索引，音频文件不会离开本机。

挑一首歌词完整的歌播放，歌词开始随节拍绘制全屏动画；画面没动多半是歌词不全，换一首再试。
在设置里能切换视觉主题，或让 AI 按歌曲生成背景主题。

排错

现象	原因	处理
macOS 首次打开提示「Folia.app 已损坏」或「无法验证」	当前发布未接入 Apple Developer ID 签名与公证，下载隔离属性触发 Gatekeeper 拦截	终端执行`xattr -dr com.apple.quarantine /Applications/Folia.app`后重新打开；更新覆盖安装后属性会重新出现，命令再跑一次，详见 docs/desktop/macos-app-damaged.md
歌词动画没有反应	当前歌曲没有歌词或歌词不完整	换一首歌词完整的歌再播放
网盘里找不到要的平台安装包	镜像仅收录 Windows 与 Apple silicon 正式版	其他系统与芯片改从官方 Releases 下载

清单全部通过后，可以继续看本地音乐库管理或壁纸模式说明，把歌词动画用进日常听歌。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析