企业官网建设流程全解析

Folia 歌词动画播放器安装指南：十分钟跑起第一支歌词动效

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

Folia 是一个基于 Electron 的全屏歌词动画播放器，支持本地曲库、Navidrome 以及网易云、QQ 音乐、酷狗等在线音源。跟着这份指南走完下载、安装、启动三步，大约十分钟，你就能拥有一套能播带动效歌词的完整环境。

成果预览：装完是什么画面

主窗口打开后，顶部是搜索栏，中间铺满专辑卡片墙。点任意一首歌，全屏歌词动画立刻跟上。桌面版内置前后端运行环境，不要求你额外装依赖。

三十秒选对安装包

⚠️ 只认官方入口下发的包。网盘镜像只收录 Windows 与 Apple silicon 的正式版，Linux 不在网盘里。

Windows：双击装完直接开播

做完这一节，你应该能从开始菜单打开 Folia，看到带歌词动画的主窗口。

1. 打开 README.md，找到「快速下载」小节，复制官方网盘链接（夸克或百度均可）。
2. 使用百度盘时，输入提取码flia。
3. 先把文件转存到自己的网盘，再开始下载；中途断流可以续传。
4. 双击Folia-Setup-<版本>.exe，按默认路径一路装完。

✅ 信号：开始菜单里出现了「Folia」图标。

5. 从开始菜单启动 Folia。

✅ 信号：主窗口弹出，顶部搜索栏、中间专辑卡片墙；点一首歌能播放并看到全屏歌词动画。

macOS：dmg 四步走完

做完这一节，Folia 会出现在 Launchpad 里，能打开同样的主界面。

1. 同样从 README.md「快速下载」小节复制官方网盘链接，转存后下载。
2. 拿Folia-<版本>-arm64.dmg文件。
3. 双击 dmg，把 Folia 图标拖进应用程序文件夹。

✅ 信号：Launchpad 里出现了 Folia。

4. 首次启动若提示已损坏或被拦截，右键 Folia 图标选择「打开」，细节见 docs/desktop/macos-app-damaged.md。

✅ 信号：在 Launchpad 点开 Folia，能看到带歌词动画的主界面。

Linux：便携版与 AUR 两个入口

做完这一节，你应该能在终端里把主窗口拉起来。

便携版（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/

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

AUR（Arch）

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条目。

构建逻辑见 packaging/aur/folia-major-bin/PKGBUILD。

验收清单：3 个信号说明装好了

✅ 满足任意一条即通过：

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

排障速查

症状：黑屏、透明度或模糊异常、GPU 崩溃（Linux）

先试 swiftshader 软件渲染：

FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major

兜底：换最保守的纯软件渲染：

FOLIA_LINUX_GRAPHICS_MODE=software ./folia-major

稳定后用FOLIA_LINUX_GRAPHICS_MODE=system切回系统图形路径。

症状：便携版起不来

先试：检查folia-major可执行文件和resources/目录是否还在同一个便携包目录里。

兜底：缺一个都启动不了，重新解压完整包再试。

症状：Mac 提示"应用已损坏"

先试：右键图标选「打开」。

兜底：按 docs/desktop/macos-app-damaged.md 处理。

以上图形变量只影响 Electron 的 Linux 启动参数，不改 Web 端与同步服务配置。

跑起来之后接着做什么

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

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