企业官网建设流程全解析

Folia 歌词动画播放器安装指南：四步从选包到跑起来

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

Folia 是一款基于 Electron 的全屏沉浸式歌词动画播放器，支持本地曲库、Navidrome 与网易云、QQ 音乐、酷狗等在线音源，桌面版内置运行环境。本文按 选包 → 安装 → 启动 → 自检 四步走完流程，照做即可听上带动效的歌词。

选对文件

下载前先用下表对号入座，确定该拿哪个文件，后面只走对应平台的路线即可。

⚠️ 只从官方网盘镜像与仓库 Releases 获取安装包：网盘镜像仅收录 Windows 与 Apple silicon 的正式版，Linux 安装包只在 Releases 提供，Arch 走 AUR。

按平台安装

下面分三个系统给出安装步骤，每段走完，Folia 就能从系统的应用入口直接拉起。

Windows 安装步骤

1. 打开 README.md，找到「快速下载」小节，复制官方网盘链接（夸克或百度均可）。
2. 使用百度盘的话，输入提取码flia。
3. 先把文件转存到自己的网盘，再开始下载。 此刻你的下载目录里应出现一个Folia-Setup-<版本>.exe安装包，断流可续传。
4. 双击安装包，按默认路径装完。
5. 从开始菜单打开 Folia。 此刻主窗口弹出，顶部是搜索栏，中间是专辑卡片墙。

开始菜单出现 Folia 图标且能打开主窗口，Windows 安装即告完成。

macOS 安装步骤

1. 同样从 README.md「快速下载」小节复制官方网盘链接，转存后下载Folia-<版本>-arm64.dmg。
2. 双击 dmg，把 Folia 图标拖进「应用程序」文件夹。 此刻应用程序文件夹里应能看到 Folia，不要直接在 dmg 挂载盘中启动。
3. 首次启动若提示「应用已损坏」或「无法验证」，在终端执行：

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

4. 回到应用程序文件夹重新打开 Folia。 此刻主窗口正常弹出，首次拦截提示消失。

Launchpad 里能看到 Folia 并打开带歌词动画的主界面，macOS 安装即告完成。

Linux 安装步骤

便携版（Debian、Ubuntu、Fedora 等）

1. 到仓库 Releases 列表下载folia-major-<版本>-linux-x64.tar.gz，版本号与网盘镜像一致。
2. 放进不会被清理的固定目录，解压。
3. 在解压目录用可执行文件直接启动：

./folia-major

此刻应弹出带搜索栏与专辑卡片墙的主窗口。 4. 想要桌面启动项，把包内模板复制到用户级应用目录：

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

再把文件里的__APP_PATH__与__ICON_PATH__两个占位符替换为真实绝对路径，完整示例见 packaging/linux/README-LINUX.txt；桌面环境有要求时把该.desktop文件标记为可信。

Arch（AUR）

1. 没有 AUR Helper 先装一个，yay 或 paru 均可。
2. 执行构建安装，alsa-lib、gtk3、libxss、nss会自动装好：

yay -S folia-major-bin

3. 卡在拉取 tar.gz 时，先把同版本文件放进构建目录的源码目录，再继续构建：

makepkg -si

4. 用包管理器核对结果：

pacman -Qs folia-major

此刻输出里应能看到folia-major-bin条目。

应用列表里出现folia-major并能正常打开，Linux 安装即告完成。

首次启动与初始体验

装好后打开一次主窗口，看看 Folia 首屏给你什么。顶部是搜索栏，中间是专辑卡片墙，底部是播放控制条；点击任意一首歌立即播放，画面切到全屏歌词动画，不同主题呈现不同排版氛围，并自动适配窗口尺寸。桌面版已内置前后端运行环境，无需再装 Node.js 或任何依赖。

自检：怎么算成功

拿不准装好没有，用下面的信号逐条对照即可。

• ✅ 主窗口能打开，看得到搜索栏与专辑卡片，播放歌曲时有全屏歌词动画。
• ✅ 便携版目录下运行./folia-major能弹出带歌词的主窗口。
• ✅ Arch 上pacman -Qs folia-major输出里有folia-major-bin条目。

满足任意一条即通过。

常见问题速查

遇到打不开或显示异常，按症状执行对应动作即可，不用看原理。

• 黑屏、透明度/模糊异常、GPU 崩溃（Linux）：先切 swiftshader 软件渲染：

FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major

• swiftshader 仍不稳：换最保守的纯软件渲染，稳定后用FOLIA_LINUX_GRAPHICS_MODE=system切回系统图形路径：

FOLIA_LINUX_GRAPHICS_MODE=software ./folia-major

• 便携版起不来：检查folia-major可执行文件与resources/目录是否还在同一个便携包目录里，缺一个都启动不了。
• Mac 提示「应用已损坏」或「无法验证」：执行xattr -dr com.apple.quarantine /Applications/Folia.app后从应用程序重新打开，细节见 docs/desktop/macos-app-damaged.md。

⚠️FOLIA_LINUX_GRAPHICS_MODE变量只影响 Electron 的 Linux 启动参数，不改变 Web 端与同步服务配置。

装完后的第一件要事

验收通过后立刻做这几件事，让 Folia 真正用起来。

• 接本地音乐：导入本地文件夹，自动读取元数据、同目录歌词与封面，导入、重扫与手动匹配详见 docs/local-library-management.md。
• 接 Navidrome 与在线音源：在「设置 → 连接与集成」填服务器地址，网易云、QQ 音乐、酷狗可直接接；想再要一份 Web 版，可用 Docker Compose 全栈自托管，见 deploy/docker/README.md。
• 开壁纸模式：在「选项 → 桌面端」开启「壁纸模式」，主窗口沉到所有窗口之下当桌面歌词壁纸，说明见 docs/wallpaper-mode.md。
• 装模组：在「设置 → 模组 → 模组系统」开启后，把模组 zip 拖进面板即可安装，规范与示范模组见 mods/README.md。

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