Folia 全屏歌词动画：三条路任选，十分钟跑起来-育师

Folia 全屏歌词动画：三条路任选，十分钟跑起来

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

看效果：Folia 全屏歌词播放器长什么样

Folia 是一款以全屏沉浸式歌词为核心的音乐播放器：歌一响，歌词就被渲染成铺满整个窗口的逐字动画舞台，还能切换 Lumi 流光、Fume 浮名等多种主题。它同时接得住本地音乐库、Navidrome 和网易云、QQ 音乐、酷狗这些在线音源。读完本文，你手上就是一个装好 Windows、macOS、Linux 桌面版或 NAS Web 版的 Folia 全屏歌词播放器，点一下就能播出第一首全屏歌词动画。

按系统和网络挑一条安装路

先别急着找下载按钮，先判断走哪条路。如果你在用 Windows 或 Apple silicon 的 Mac，且能直连官方 Releases 页面，走路线一：桌面版下载，10 到 20 分钟装完；国内网络直连慢的话，路线一可以改从官方网盘镜像（夸克 / 百度）进，入口在项目首页「快速下载」一节，它提供 Windows 与 Apple silicon 安装包，断点续传也更省心。如果你在 Linux 上，走路线二：Arch 系一条 AUR 命令，其他发行版解压便携包直接启动，5 到 10 分钟。如果你不打算在桌面上用，而是想让手机和浏览器都能打开，走路线三：在 NAS 或服务器上 Docker 自部署 Web 版，30 分钟起，一次部署多端能连。

三条路，挑一条。

Windows 装好 Folia 全屏歌词播放器

准备

只需要一个文件：官方 Releases 里的Folia-Setup-0.7.23.exe（版本号以 Releases 页面为准），或官方网盘里的同名文件。无需任何前置工具。

操作

下载安装包。走网盘的话，建议先把文件转存到自己网盘再下载，中断可续传。
双击运行安装程序。NSIS 向导支持修改安装目录，一路确认即可。
启动 Folia：安装完成后从开始菜单进入。桌面版内置前后端运行环境，装完即用。

注意：只装官方渠道的分发包，来路不明的转包一律不碰。

跑通确认

打开 Folia，在「关于」页核对版本号与下载文件名一致；随便播一首带歌词的歌，全屏歌词动画正常渲染，就算装完了。

macOS 按芯片下载对版 dmg

准备

先确认芯片：「关于本机」里是 Apple silicon（arm64）还是 Intel（x64），两者安装包文件名不同。官方网盘只有 Apple silicon 版，Intel Mac 必须走 Releases。

操作

从 Releases 页面下载对应芯片的Folia-0.7.23-arm64.dmg或Folia-0.7.23-x64.dmg。
打开 dmg，把Folia.app拖进Applications，别在挂载盘里直接运行。
如果首次打开弹出「应用已损坏」或「无法验证」，打开终端执行下面命令——这是缺 Apple Developer ID 签名导致的拦截，不是真损坏：

xattr -dr com.apple.quarantine /Applications/Folia.app

回到Applications重新打开Folia.app。

就这步，别跳。macOS 版暂不支持应用内自动更新，以后每次覆盖安装新 dmg，都要重跑一次这条xattr命令。更多细节见 docs/desktop/macos-app-damaged.md。

跑通确认

启动后主题正常渲染、能搜索并播放在线歌曲，说明 Gatekeeper 的拦截已经解除，安装成功。

Linux 装进 AUR 或解压便携包

准备

Arch 系走 AUR 包folia-major-bin，前提是已装yay或paru；其他发行版走 Releases 里的folia-major-0.7.23-linux-x64.tar.gz。

操作

如果你在用 Arch 系发行版，执行 AUR 命令（paru用户把yay换成paru）：

yay -S folia-major-bin

构建会自动解决alsa-lib、gtk3、libxss、nss依赖，程序装进/opt/folia-major并生成启动项。别踩坑：AUR 包版本常落后，依赖清单见 packaging/aur/folia-major-bin/PKGBUILD；想装最新版，先手动下好同版本 tar.gz 放进源码目录，再执行makepkg -si。

如果你在其他发行版（Ubuntu、Debian、Fedora），改为下载folia-major-0.7.23-linux-x64.tar.gz，解压到任意目录，执行下面命令启动：

./folia-major

创建桌面启动项：把包内resources/linux/folia-major.desktop复制到~/.local/share/applications/，将__APP_PATH__、__ICON_PATH__替换为可执行文件与resources/linux/icon.png的绝对路径，再按桌面环境要求标记为可信。完整说明见 packaging/linux/README-LINUX.txt。

跑通确认

启动后看到 Folia 主界面、窗口正常渲染即成功。下面这张是 Linux 下接入网易云首页的实际截图。

装好了吗？往下看。

Docker 自部署 Folia Web 版

准备

要求 Docker Engine24+ 与 Composev2；NAS 上准备一个空目录，外加仓库deploy/docker/目录里的compose.yaml和.env.example两个文件。

操作

克隆仓库，把deploy/docker/里的compose.yaml和.env.example复制到空目录：

git clone https://gitcode.com/GitHub_Trending/fo/folia-major

重命名.env.example为.env，执行openssl rand -hex 32生成随机串，把输出填入SYNC_TOKEN。
校验配置并启动：

docker compose config docker compose up -d --wait

浏览器访问http://NAS-IP:18080进入 Web 端，http://NAS-IP:13000/health检查 Sync Server 状态。

注意：本地音乐目录访问依赖可信 HTTPS 安全上下文，NAS 上需自行配置反向代理与证书，步骤见 deploy/docker/README.md。

跑通确认

浏览器打开http://NAS-IP:18080能看到 Folia 首页并正常搜索播放，自部署成功。

卡住了，看这里

下载中断或特别慢：官方网盘只覆盖 Windows 与 Apple silicon，这两类直接换网盘镜像；Intel Mac 与 Linux 包继续走 Releases。
Folia.app 已损坏 / 无法验证：缺 Apple 签名被 Gatekeeper 拦截，终端执行xattr -dr com.apple.quarantine /Applications/Folia.app后重新打开；macOS 15 起「Control 点击打开」已失效，别在这上面浪费时间。
Linux 启动黑屏 / 透明度异常 / 闪退：GPU 兼容问题，先FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major验证，仍不稳定再改FOLIA_LINUX_GRAPHICS_MODE=software；X11 下可加FOLIA_LINUX_VULKAN=1 ./folia-major --ozone-platform=x11开启 WebGPU，原生 Wayland 下别开 Vulkan。
版本和最新 Release 对不上：网盘镜像与 AUR 包都会滞后，下载前把文件名版本号与 Releases 页比对；不一致就下官方最新包，Arch 用户可手动下 tar.gz 本地构建。
dmg 解压后打不开 / 安装中途报错：多半是下载中断导致文件不完整，重新下载一次；确认运行的是Applications里的正式应用，而不是挂载盘里的临时版本。

装完后，去折腾这些

桌面版装好后，先导入一个本地音乐文件夹——Folia 会自动匹配在线歌词和封面，本地文件只存索引、不会上传。想再进一步，可以在「设置 → 模组」里打开 Folium 模组系统，换歌词动画、背景和播放页图层。更多技术细节、环境变量与本地开发见 docs/technical.md，模组开发从 docs/folium/quickstart.md 开始。装好了，剩下的玩去吧。

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