企业官网建设流程全解析

Folia 歌词动画播放器下载与安装完整指南：Windows、macOS、Linux 四条路径任选

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

Folia 是一款把歌词渲染成全屏动画的音乐播放器，接入网易云、酷狗、Navidrome 和本地音乐库都能用。这篇 Folia 下载与安装教程按你的系统拆成四条路线：国内走网盘、Intel Mac 走 Releases 页面、Arch 系走 AUR、其他 Linux 发行版走便携版，每步都给出具体命令和判好标准。

装好长什么样：三个信号确认 Folia 安装成功

不管你是从网盘装的、Releases 装的还是 AUR 装的，Folia 是否装好只看三个信号，全中才算落地：

• 应用菜单里能找到 Folia 入口——Windows 看开始菜单，macOS 看 Applications，Linux 看应用菜单
• 点进去能正常进首页，歌单 / 文件夹标签页和搜索框都在
• 随便放一首歌，全屏歌词动画真的在动

三条都满足就可以直接用了。接下来按平台分节，你跳到对应的那一节即可。

对号入座：你的系统该走哪条下载渠道

• 国内网络 + Windows 或 Apple silicon Mac→ 网盘镜像（夸克、百度两条链），国内速度最稳，是取包最快的路
• Intel Mac→ 项目 Releases 页面的 dmg，网盘里没有 Intel 包
• Arch / Arch 系，已装 yay 或 paru→ AUR 助手一条命令，预编译包直接进/opt，免手动解压
• Debian / Ubuntu / Fedora 等其他发行版→ linux-x64 便携版手动部署，官方对非 Arch 系只给便携包这一种形态

这里只提醒一次：网盘真正只有 Windows 与 Apple silicon 两个包，Intel Mac 或任何 Linux 都别在这耗时间。

Folia 网盘下载：国内 Windows 与 Apple silicon 三分钟取包

1. 打开项目README.md的「快速下载」一节，拿到夸克与百度两条网盘链接（百度提取码flia）。
2. 对一眼网盘里的版本号和最新 release，明显落后就转去 Releases 页面；不落后就直接取包：Windows 拿.exe，macOS 拿.dmg。
3. 执行安装：Windows 双击安装器按提示走完；macOS 挂载 dmg 后把Folia.app拖进 Applications。
4. 从开始菜单或 Applications 里启动 Folia，首页长这样：

⚠️ 网盘里始终只有 Windows 与 Apple silicon 两个包，Intel Mac 和 Linux 请直接走 Releases；网盘链接失效时，回README.md「快速下载」一节取最新链接。

Folia macOS 安装（Intel 芯片）：去 Releases 页面取 dmg

Intel 芯片的 Mac 在网盘里没有包可下，只能自己上项目 Releases 页面取 dmg。

1. 进入 Releases 页面，下载当前版本、对应 Intel Mac 的 dmg 文件。
2. 挂载 dmg，把Folia.app拖入 Applications，不要在挂载盘里直接运行。
3. 首次启动时 macOS 弹出「应用已损坏」或「无法验证」属于正常拦截，打开终端移除下载隔离属性即可：

xattr -dr com.apple.quarantine /Applications/Folia.app # 移除隔离属性后再从 Applications 打开

⚠️ 当前 macOS 版没有 Developer ID 签名与公证，首次被 Gatekeeper 拦是预期内的；应用暂不支持自动更新，之后每次手动重装都要再执行一遍这条 xattr 命令。

Folia AUR 安装：Arch 系一条命令落地

已经装好 yay 或 paru 的 Arch 用户，这是全自动程度最高的一条路。

1. 先确认 AUR 助手可用：yay --version
2. 安装预编译二进制包（paru 用户把命令名换成paru）：

yay -S folia-major-bin # 构建时从 Releases 拉取 linux-x64 包，装进 /opt/folia-major

3. 验证命令可直接执行——包会在/usr/bin建软链接，which folia-major应输出/usr/bin/folia-major
4. 在应用菜单里找到 Folia，启动它。启动后的在线音源首页：

⚠️ AUR 包当前版本号0.1.4，依赖alsa-lib、gtk3、libxss、nss四项，打开packaging/aur/folia-major-bin/PKGBUILD可以逐项核对；构建卡在下载环节一般就是网络问题，不用干等，直接转下面的便携版。

Folia Linux 部署（Debian / Ubuntu / Fedora）：linux-x64 便携版手动落地

非 Arch 系发行版，或者想把程序收进一个固定目录的用户，官方只给便携包这一种形态。

1. 到 Releases 页面下载当前版本的 linux-x64 包，文件名形如folia-major-<version>-linux-x64.tar.gz。
2. 解压到一个固定目录：

mkdir -p ~/Apps/Folia && tar -xzf folia-major-*-linux-x64.tar.gz -C ~/Apps/Folia # 整套程序放进固定目录

3. 包里的桌面启动项模板要放进用户级应用目录：

cp ~/Apps/Folia/resources/linux/folia-major.desktop ~/.local/share/applications/ # 复制桌面项模板

4. 编辑复制出来的.desktop，里面有两个占位符要填：__APP_PATH__换成 folia-major 可执行文件的绝对路径，__ICON_PATH__换成resources/linux/icon.png的绝对路径。
5. 桌面环境有要求时，把这个.desktop标记为可信，然后从应用菜单启动 Folia。装好后的本地音乐库页面：

⚠️ 便携包一共就三样东西：folia-major可执行文件、resources/linux/icon.png、桌面项模板。排障第一步，确认可执行文件和resources/是不是来自同一个包。

坏在哪里看哪里：Folia 安装故障对照

按现象对号入座，基本都能当场解决：

网盘渠道

• 网盘里找不到自己平台的包（Intel Mac / Linux）→ 去 Releases 页面取对应平台的包
• 网盘版本落后于最新 release，或链接失效 → 以README.md「快速下载」一节的最新镜像链接为准

AUR 渠道

• AUR 构建卡在下载步骤 → 放弃 AUR，转 linux-x64 便携版手动部署

macOS

• 提示「应用已损坏」或「无法验证」→ 终端执行xattr -dr com.apple.quarantine /Applications/Folia.app移除隔离属性

Linux 图形

• 启动后黑屏、透明度 / 模糊异常或 GPU 崩溃 →FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major，先强制走 swiftshader 软件渲染
• swiftshader 下仍不稳定 → 把变量值改成software，即FOLIA_LINUX_GRAPHICS_MODE=software ./folia-major，这是最保守的软件渲染档位

桌面快捷方式

• 快捷方式不显示 → 检查.desktop的Exec/Icon是否填了绝对路径，并把文件标记为可信

装好之后接着读：仓库内几份真实文档

• docs/technical.md：Linux 图形模式、Wayland / Hyprland 遥控窗等桌面端细节，黑屏问题的进阶解法都在这份里
• packaging/linux/README-LINUX.txt：便携包自带的说明书，讲清包里三样东西和全部图形环境变量
• packaging/aur/folia-major-bin/PKGBUILD：AUR 包的依赖、安装路径与软链接逻辑，可逐项核对
• docs/local-library-management.md：装好之后本地音乐库的导入、重扫与在线歌词匹配玩法
• deploy/docker/README.md：不想装桌面端时的备选路线，Docker Compose 全栈部署 Web 版本

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