企业官网建设流程全解析

Folia 歌词动画播放器安装指南：Windows、macOS、Linux 三平台从取包到启动

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

Folia 是一个把歌词渲染成全屏动画的播放器，支持网易云音乐、酷狗、Navidrome 以及本地音乐库。装完在 Windows、macOS 或 Linux 的应用菜单里点一下 Folia，就能进入在线音源或本地音乐库的首页。

装前准备

1. 取包入口：桌面安装包都在仓库官方 Releases 页面；国内网络慢的话，看 README.md「快速下载」一节的夸克网盘 / 百度网盘镜像，注意网盘只有 Windows 和 Apple silicon 两种包。
2. 下载前核对三样东西：平台（Windows / macOS / Linux）、架构（x64 与 arm64、Intel 与 Apple silicon）、版本号。当前桌面版版本号为0.7.23，文件名里的数字要对上；网盘版本如果比这旧，直接回官方 Releases 取。
3. 前置依赖：桌面版内置运行环境，不用预装 Node.js 或编译工具；Arch 用户需要 yay 或 paru 这类 AUR 助手；Linux 需要有正常桌面环境。

各平台包名对照：

分平台安装

Windows 安装包从哪取、怎么装

1. 到官方 Releases 页面下载Folia-Setup-0.7.23.exe。
2. 双击运行，按向导点完即可，不需要额外装依赖。

开始菜单里出现 Folia、点开是首页，这步就成了。

macOS 按芯片取 dmg

1. Apple silicon（M 系列）下载Folia-0.7.23-arm64.dmg，Intel Mac 下载Folia-0.7.23-x64.dmg。网盘镜像只有前者，Intel Mac 直接走官方 Releases，别在网盘上耗时间。
2. 双击 dmg 挂载后，把Folia.app拖进Applications，不要直接在挂载盘里运行。
3. 弹"应用已损坏"时先执行：

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

应用菜单里出现 Folia、打开进入首页，这步就成了。

Linux 按发行版取包

Arch / Manjaro

1. 确认 AUR 助手可用：yay --version。
2. 执行安装：

yay -S folia-major-bin

用 paru 的用户改成paru -S folia-major-bin。这个 AUR 包本质是去官方 Releases 拉 linux-x64 包装到/opt/folia-major，运行时依赖 alsa-lib、gtk3、libxss、nss，构建卡在下载环节就别干等，直接改用下面的便携部署。

Debian / Ubuntu / Fedora / openSUSE

下载对应发行版的包后安装：

sudo dpkg -i folia-major-0.7.23-linux-amd64.deb

sudo rpm -i folia-major-0.7.23-linux-x86_64.rpm

其他发行版：便携版手动部署

1. 下载folia-major-0.7.23-linux-x64.tar.gz，解压到固定目录：

tar -xzf folia-major-0.7.23-linux-x64.tar.gz -C ~/Apps/Folia

2. 复制桌面启动项模板：

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

3. 编辑复制后的文件，把__APP_PATH__替换成~/Apps/Folia/folia-major的绝对路径，__ICON_PATH__替换成~/Apps/Folia/resources/linux/icon.png的绝对路径。
4. 桌面环境要求的话，把这个 .desktop 文件标记为可信。

终端能执行folia-major命令、应用菜单里出现 Folia，这步就成了。

装完怎么验

• 打开看一眼首页：应该落在在线音源（网易云 / 酷狗 / Navidrome）的登录或搜索页，或本地音乐库导入页，没有白屏、黑屏。
• 放一首带歌词的歌：播放时全屏歌词动画正常出现、封面和歌词都加载出来，说明渲染链路没装歪。
• 本地库用户：导入目录后歌曲列表能出封面，说明本地索引工作正常。

高频踩坑速查

现象：Linux 启动后黑屏，或透明度、模糊异常，甚至 GPU 崩溃。原因：GPU 驱动与 Electron 图形栈不兼容，不是装错了。解法：先切软件渲染再下结论：

FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major

仍不稳定的机器再退一档：

FOLIA_LINUX_GRAPHICS_MODE=software ./folia-major

现象：macOS 提示"Folia.app 已损坏，无法打开"。原因：当前 macOS 包没有 Apple Developer ID 签名与公证，Gatekeeper 拦截。解法：

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

现象：Linux 便携版解压后应用菜单里没有 Folia，或快捷方式点了没反应。原因：.desktop 里的__APP_PATH__/__ICON_PATH__没替换成绝对路径，或文件没标记可信。解法：检查 .desktop 中 Exec 与 Icon 都是绝对路径，把文件标记可信后从应用菜单启动。

现象：网盘镜像里找不到要的平台包，或版本号偏旧。原因：网盘只放了 Windows 与 Apple silicon 两种包，且版本可能落后官方 Releases。解法：回官方 Releases 页面取包，网盘链接的时效以 README.md「快速下载」一节为准。

延伸阅读

• docs/technical.md：Linux 图形模式、Wayland / Hyprland 遥控窗等桌面端细节
• docs/desktop/macos-app-damaged.md：macOS 提示"应用已损坏 / 无法验证"的原因与修法
• packaging/linux/README-LINUX.txt：便携版目录结构、图形变量与壁纸模式说明
• deploy/docker/README.md：Docker Compose 全栈部署 Web 版本，不想装桌面端时的另一条路 🎵

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