企业官网建设流程全解析

Folia 歌词动画播放器安装指南：3 条路线 10 分钟装到能播放

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

Folia 是把歌词渲染成全屏动画的音乐播放器，支持本地音乐库、Navidrome 与网易云、QQ 音乐、酷狗等在线源。本文只解决一件事：把 Folia 装进你的电脑并真正跑起来，避开下载慢、安装失败、启动黑屏这几个常见卡点。

先问自己三句话，锁定安装路线

选错路线会白跑一遍，回答下面三个问题：

1. 系统是 Windows，或者 Apple 芯片的 Mac？走「官方安装包」主线：国内网络走网盘镜像，网络正常直接去 Releases 页面取包。
2. 是 Arch 或 Arch 系发行版？走 AUR 助手一条命令：yay -S folia-major-bin。
3. 其余桌面发行版（Debian、Ubuntu、Fedora…）？走便携版手动部署：解压 tar.gz + 手工建桌面启动项。

三者都覆盖桌面端 Electron 安装包；没有电脑、想在手机浏览器里用，见文末自托管说明。

Windows 完整安装步骤：从网盘到首次播放

前置检查

• 确认是 64 位 Windows 系统，预留 2 GB 以上磁盘空间
• 打开 README.md「直接下载」一节，确认夸克 / 百度网盘镜像链接可用
• 网盘镜像只提供 Windows 与 Apple silicon 两个正式版安装包，且版本可能落后于最新 release，下载前先对照版本号

操作清单

1. 从 README「直接下载」一节取网盘链接，下载.exe安装包
2. 双击安装包，按向导完成安装
3. 从开始菜单启动 Folia
4. 在搜索框输入歌名，播放第一首歌

如何验证装成功

启动后窗口正常出现、能搜索并播放歌曲、进度条走动，即安装成功。若启动后窗口长时间空白，先看下方故障速查表的「启动黑屏」一行。

装完长什么样

登录网易云后，主界面以全屏歌词动画呈现，不同主题对应不同排版氛围：

macOS 变体：绕过"应用已损坏"拦截

什么时候走这条路：Mac 用户，且双击后弹出"Folia.app已损坏，无法打开"。

前置检查

• Apple silicon 机型可从网盘镜像取.dmg；Intel Mac 不在网盘覆盖范围内，需直接去 Releases 页面取对应包
• 下载中断过的包先重新下载，排除包体损坏

操作清单

1. 把Folia.app拖进Applications，不要在挂载的 dmg 窗口里直接运行
2. 按住Control点击Folia.app，选择「打开」，弹窗中再点一次「打开」
3. 仍被拦截时进「系统设置 → 隐私与安全性」，点「仍要打开」
4. 两种界面方式都失败时，终端执行：

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

原因说明：当前 macOS 版本未做 Apple Developer 签名与公证，Gatekeeper 把未公证应用标成高风险，叠加下载隔离属性后就显示成"已损坏"，包体本身没有问题。完整方案见 docs/desktop/macos-app-damaged.md。

验证

启动后播放任意一首歌，歌词动画正常渲染即成功。

Arch 变体：AUR 助手一条命令

什么时候走这条路：Arch 或 EndeavourOS 等 Arch 系，已装好 AUR 助手。

前置检查

确认助手可用：yay --version或paru --version。想核对构建细节时，看仓库内的 packaging/aur/folia-major-bin/PKGBUILD：当前包版本0.1.4，依赖alsa-lib、gtk3、libxss、nss，安装到/opt/folia-major并软链到/usr/bin/folia-major。

操作清单

yay -S folia-major-bin # 或 paru -S folia-major-bin

验证

• 终端执行which folia-major，应输出/usr/bin/folia-major
• 在应用菜单中找到 Folia 并启动，能正常播放即成功

踩坑

AUR 包的本质是去 Releases 下载folia-major-<版本>-linux-x64.tar.gz再打包。构建日志卡在下载步骤时不要干等，直接切到下一节的便携版手动方式。

其他 Linux 变体：便携版手动部署

什么时候走这条路：Debian、Ubuntu、Fedora 等不走 AUR 的桌面发行版。

前置检查

• 从 Releases 页面取folia-major-<版本>-linux-x64.tar.gz
• 准备一个长期保留的目录（如~/Apps/Folia），便携包依赖「可执行文件与resources/同目录」的结构

操作清单

1. 解压到固定目录：

mkdir -p ~/Apps/Folia tar -xzf folia-major-<版本>-linux-x64.tar.gz -C ~/Apps/Folia

2. 复制桌面模板到应用目录：

cp ~/Apps/Folia/resources/linux/folia-major.desktop ~/.local/share/applications/folia-major.desktop

3. 编辑复制后的.desktop文件，把两处占位符换成实际绝对路径：

Exec=__APP_PATH__ -> Exec=/home/你的用户名/Apps/Folia/folia-major Icon=__ICON_PATH__ -> Icon=/home/你的用户名/Apps/Folia/resources/linux/icon.png

4. 桌面环境要求的话，把该.desktop标记为可信
5. 在应用菜单启动 Folia；完整说明见 packaging/linux/README-LINUX.txt

验证

• 应用菜单出现 Folia 且能启动出窗口
• 播放一首本地歌曲，歌词随播放推进动画

踩坑

启动后黑屏、透明度/模糊异常或 GPU 崩溃时，先加软件渲染变量再试：

FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major

仍不稳定就换最保守档：FOLIA_LINUX_GRAPHICS_MODE=software ./folia-major；确认稳定后想用回系统图形路径，设FOLIA_LINUX_GRAPHICS_MODE=system。

现象 → 处理速查

桌面启动项细节、Wayland 壁纸模式与遥控窗行为，见 docs/technical.md；没有桌面、想部署到手机或浏览器，按 deploy/docker/README.md 走 Docker 自托管，再把 Web 版装成 PWA 🎵

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