如何快速装好 Folia 歌词动画播放器：分系统下载、安装与启动完整教程

如何快速装好 Folia 歌词动画播放器：分系统下载、安装与启动完整教程

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

Folia 是一款把歌词渲染成全屏动画的歌词动画播放器，支持网易云、QQ 音乐、酷狗、Navidrome 与本地音乐库。本文是一份 Folia 下载与安装指南，总原则：先定下"你用什么系统、网络是否顺畅"，再动手拿包。

一张表定路线：分系统选包对照

第一步是选对包：按你的当前处境在下表定位，再去对应入口拿。

注意：网盘镜像只有 Windows 与 Apple silicon 两个正式版安装包，Intel Mac 与全部 Linux 平台不在其中，一律回 Releases 页面拿对应平台的包。

三点前提：

• 桌面版是 Electron 打包的完整应用，运行环境已内置，本地无需安装 Node.js 或任何依赖，装完即用。
• Linux 便携包没有安装过程：内容就是一个folia-major可执行文件加一个resources/目录（内含图标与.desktop模板），放在哪个目录由你决定。
• 桌面版与 Web 版是两条独立的版本线，版本号不一致属正常现象，各取各的最新版即可。用 Navidrome 自建源的话，装好桌面版后在「设置」里填服务器地址即可连接。

图形界面安装：Windows 与 macOS

两个平台都是安装式，关键是选对架构，并把「下载 → 安装 → 首次启动」的顺序做对。

Windows x64：下载与安装步骤

1. 拿包：打开项目 Releases 页面下载Folia-Setup-<版本>.exe；直连较慢时，转去 README「快速下载 / 直接下载」一节的夸克网盘或百度网盘（提取码flia）。
2. 核对版本：把文件的版本号与 Releases 页面最新 release 对一遍，一致再继续；镜像版本未必是最新，有落差就换直连。
3. 安装：双击.exe，按向导装完。
4. 首次启动：从开始菜单启动 Folia。

macOS：Apple silicon 与 Intel 的安装与首次启动

1. 拿包：Apple silicon（M1/M2/M3 等）取Folia-<版本>-arm64.dmg，网盘镜像与 Releases 都有；Intel Mac 取Folia-<版本>-x64.dmg，该包仅在 Releases 提供。
2. 安装：双击 dmg 挂载后，把Folia.app从 dmg 窗口拖进「应用程序」。不要在挂载盘里直接运行，启动路径不会保留。
3. 首次启动：从「应用程序」启动。若首次打开提示「Folia.app 已损坏，无法打开」，是系统给文件打了下载隔离标记所致，任选其一即可：按住 Control 点击应用选「打开」；在「隐私与安全性」中点「仍要打开」；或在终端执行xattr -dr com.apple.quarantine /Applications/Folia.app直接移除该隔离标记。

Linux 部署：手动路线与 Arch 捷径

Linux 有两条路线：便携包手动部署适用于全部 x86_64 发行版，Arch 系有一条命令的捷径。

非 Arch 发行版：Linux 便携包部署步骤

适用于 Debian、Ubuntu、Fedora 等 x86_64 发行版，产物是 Releases 页面的folia-major-<版本>-linux-x64.tar.gz。

1. 下载 tar.gz：从项目 Releases 页面取对应文件（网盘镜像中没有）。
2. 解压到固定目录：例如~/Apps/Folia/，日后升级也放同一目录，版本集中一处管理。
3. 复制桌面模板：把包内resources/linux/folia-major.desktop复制到~/.local/share/applications/。
4. 替换占位符：打开复制出的文件，将__APP_PATH__与__ICON_PATH__两处替换为可执行文件和图标的实际绝对路径。
5. 标记可信并启动：按桌面环境要求把该.desktop文件标记为可信，之后即可从应用菜单启动，或在解压目录执行./folia-major。完整说明与路径示例见 packaging/linux/README-LINUX.txt。

Arch：一条命令安装

1. 确认yay或paru可用。
2. 执行yay -S folia-major-bin。
3. 完成后从应用菜单启动。

这条命令做的事情：从 Releases 拉取最新 Linux 包、安装到/opt/folia-major、创建桌面启动项，并一并处理 alsa-lib、gtk3、libxss、nss 四个依赖。提前了解两点：AUR 包版本（当前 PKGBUILD 是 0.1.4）可能落后于 Releases 最新版，在意版本就改拿便携包；构建若卡在下载环节，说明你到 Releases 的直连不通，此时改走上节的手动部署路线。

装完 30 秒验证

验证只有三步，全部通过即安装成功。

1. 首页渲染：启动应用，确认首页正常显示，无白屏黑屏。
2. 搜索歌曲：搜一首你熟悉的歌，确认能播放。
3. 看歌词：确认播放时歌词以动画形式铺满全屏。

装好之后的日常：导入本地歌曲会自动匹配在线歌词与封面；Navidrome 等在线源的连接设置都在「设置」里，填入服务器地址即可。本地音乐库目录若想自托管，可参考 deploy/docker/README.md 的 Docker 方案。

启动异常排查

先分平台、再对症状，每条给一句原因与一条解法。

• macOS
  • 启动提示「Folia.app 已损坏，无法打开」：原因是下载隔离标记拦截了应用。按上文 macOS「首次启动」的三种方式处理，最彻底的是用xattr命令移除该标记。
• Linux
  • 启动黑屏、透明度或模糊异常：本地 GPU 驱动与图形栈不配合，无需重装。用FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major启动。
  • swiftshader 仍不稳定：换更保守的FOLIA_LINUX_GRAPHICS_MODE=software ./folia-major启动。
  • 这两个环境变量的作用：强制应用使用内置的软件光栅化渲染，绕开你自己的 GPU 驱动问题。
• 下载环节
  • 网盘链接失效或版本太旧：镜像只含 Windows 与 Apple silicon 两个安装包，且不保证跟得上最新 release。以 README「直接下载」一节的最新链接为准，再不行回 Releases 页面。
  • AUR 构建卡在下载：AUR 包本质是从 Releases 拉 tar.gz，卡住即直连不通。改走「非 Arch 发行版」的手动部署路线。

Linux 没有自动更新通道，升级就是下载新版 tar.gz 重新解压覆盖原目录。装好之后，可以把「设置」里常用的在线源连接配好，确认本地库就绪。若想继续了解 Wayland 壁纸模式、遥控窗等桌面细节，或再遇到 macOS 拦截问题，下方「进一步阅读」有对应文档。三步验证都通过，就可以正常听歌了 🎵

进一步阅读

• 桌面项细节、Wayland 壁纸模式、遥控窗与更多平台差异：docs/technical.md
• macOS「应用已损坏」完整排查（含 Gatekeeper 原理）：docs/desktop/macos-app-damaged.md

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