企业官网建设流程全解析

Folia 歌词动画播放器安装指南：十分钟装好，桌面听歌即刻带动效

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

Folia 是一款基于 Electron 的全屏歌词动画播放器，支持本地曲库、Navidrome 与网易云、QQ 音乐、酷狗等在线音源。读完本文，你即可完成 Folia 歌词动画播放器的安装与首次启动，全程约十分钟。

开工前的准备：拿对包

装错包会浪费后面大半步骤，先确认你的系统该走哪条路：

打开仓库 README.md，在「快速下载」小节复制官方网盘链接；使用百度盘的话，输入提取码flia。先把文件转存到自己的网盘再开始下载，中途断流可以续传。

⚠️ 网盘镜像只收录 Windows 与 Apple silicon 的正式版，Linux 不在网盘里，请直接到仓库 Releases 取 tar.gz。

三步装完：取包 → 安装或解压 → 启动

不管哪个系统，都是同样三步，平台差异各用一行交代清楚。

第一步：取包

• Windows / macOS：从网盘链接下载.exe或.dmg文件。
• Linux：到 Releases 下载folia-major-<版本>-linux-x64.tar.gz，版本号与网盘镜像保持一致。
• Arch：跳过手动下载，交给 AUR 拉取。

第二步：安装或解压

• Windows：双击Folia-Setup-<版本>.exe，按默认路径一路装完。
• macOS：双击.dmg，把 Folia 图标拖进应用程序文件夹。
• Linux：把 tar.gz 放到不会被清理的固定目录解压，保证可执行文件与resources/目录位于同一便携包目录内。
• Arch：没有 AUR Helper 就先装一个（yay 或 paru 都行），然后执行构建，alsa-lib、gtk3、libxss、nss等依赖会自动装好：

yay -S folia-major-bin

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

makepkg -si

第三步：启动

• Windows：此刻开始菜单里应能看到「Folia」图标，点它打开主窗口。
• macOS：在 Launchpad 里点开 Folia，主窗口随即弹出。
• Linux：在终端进入便携包目录，用可执行文件直接启动：

./folia-major

想要桌面启动项的话，把包内模板复制到用户级应用目录：

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

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

启动后第一眼：看到什么才算成功

✅ 满足任意一条即算装好，逐条对一下：

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

卡住就看这里：常见启动问题速查

照症状查表执行即可，不用看原理。

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

装完之后的四个方向

• 接曲库：导入本地文件夹，自动读取元数据、同目录歌词与封面；Navidrome 与网易云、QQ 音乐、酷狗在「设置 → 连接与集成」填地址即可接上，细节见 docs/local-library-management.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