Folia 全屏歌词播放器安装教程：三端 15 分钟跑起来

Folia 全屏歌词播放器安装教程：三端 15 分钟跑起来

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

Folia 是一款把歌词渲染成全屏沉浸动画的全屏歌词播放器，支持网易云、QQ 音乐、酷狗在线音源，也能接入 Navidrome 和本地曲库。这篇 Folia 安装教程按 Windows、macOS、Linux 三端顺序讲解，照做之后你就能在任一平台完成安装，并亲眼看到整屏歌词亮起来。

先选路线：三条 Folia 安装路线对比

下载之前先定路线。三条路线面对的人群和成本差异不小，对号入座一下：

桌面版把前后端运行环境都打包进了安装包，装完即用，不需要 Node.js，也不需要任何开发工具。拿不准就从桌面路线开始，它覆盖的场景最多。

成功标志：你能说清自己走哪条路线，以及手里有没有对应的前置条件。

桌面版安装：三端的安装动作

无论哪个系统，流程都一样：找到文件、完成安装、验证启动。唯一要记住的是，下载完成后把文件名里的版本号与 Releases 页最新标注对一遍，若不一致，先等镜像同步，或改回 Releases 重新下载。

Folia Windows 安装：下载 64 位安装包

找到文件。到 Releases 页选 64 位 .exe 安装包。国内网络也可以走官方网盘镜像（夸克、百度），Windows 正式版在镜像覆盖范围内。

完成安装。双击 .exe，跟着安装向导一路点完，没有需要额外配置的选项。

验证成功。装完在开始菜单里找到 Folia 图标，双击能打开主窗口，Windows 端就算装完。

Folia macOS 安装：把 .dmg 拖进 Applications

找到文件。Apple silicon（M 系芯片）选对应平台的 .dmg。Intel 版本不在网盘镜像里，直接去 Releases 页下载。

完成安装。打开 .dmg，把 Folia 图标拖进 Applications 文件夹即可。

验证成功。启动台里出现 Folia 并能打开主窗口，macOS 端完成。

Folia Linux tar.gz：解压即运行，再配桌面启动项

找到文件。到 Releases 页选与 CPU 架构匹配的 .tar.gz，x86_64 和 ARM 两种包互不通用，逐字核对文件名里的标识。Linux 包没有网盘镜像，只能走 Releases。

完成安装。把 .tar.gz 解压到任意目录，直接运行里面的 folia-major 可执行文件。它是便携包，没有系统级安装步骤。

验证成功。终端里运行后主窗口能弹出即算核心完成；若黑屏或闪退，先看文末的排查表。

配置桌面启动项。想从应用菜单启动，把模板文件resources/linux/folia-major.desktop复制到~/.local/share/applications/，把__APP_PATH__和__ICON_PATH__两个占位符分别替换为可执行文件和图标的绝对路径；若桌面环境有要求，再把该 .desktop 文件标记为可信或可执行。完整说明见 README-LINUX.txt。

成功标志：系统应用入口（开始菜单、启动台或应用菜单）里出现 Folia 图标，且能打开主窗口。

Folia 启动后第一件事

首次启动后，把下面四项逐一对照，看到右侧的结果即算通过：

• 🏷️版本号：「关于」页显示的版本与安装包文件名一致 → 成功
• 🔑音源：登录网易云、QQ 音乐或酷狗后登录态保持，或导入本地文件夹、接入 Navidrome 后能看到曲库 → 成功
• 🎤歌词动画：播放一首带歌词的歌，全屏动画铺满屏幕 → 成功
• 🎨主题：切换两三个主题，排版氛围有明显变化 → 成功

成功标志：checklist 四项全部通过，这篇 Folia 教程就算走完。

可选路线：AUR、构建加速、Web 部署

Folia AUR：Arch 上一条命令装完

Arch 用户跳过下载环节，终端执行：

yay -S folia-major-bin

paru 用户把命令里的yay换成paru即可。依赖项会自动解决，程序安装到/opt/folia-major。

成功标志：应用菜单出现 Folia，打开后主窗口正常弹出。

用网盘加速 AUR 本地构建

若构建阶段拉压缩包太慢，先通过网盘下好同版本的 Linux 包，放进 AUR 源码目录，再执行makepkg -si完成安装。依赖清单和安装位置都写在 PKGBUILD 里，需要核对就看这个文件。

成功标志：makepkg 正常收尾，应用菜单出现图标，启动效果与手动安装一致。

Folia Web 部署：浏览器里听，手机变 PWA

不想装桌面端，可以部署到 Vercel 或 Cloudflare，也可以走 NAS 上的 Docker 全栈，步骤在 deploy/docker/，整体耗时按几十分钟算。部署完成后浏览器打开页面就能直接听；把页面添加为 PWA，手机上也能当 App 使用。

成功标志：浏览器里能播放在线音源的歌曲并看到全屏歌词动画，手机主屏幕出现 PWA 图标。

Folia 出问题时先查这里

成功标志：问题消除，或定位到原因后知道下一步该做什么。

选一首带歌词的歌，按下播放，让整块屏幕亮起来——这篇教程到此结束；接下来可以切换 img/ 里预览过的主题效果、接入桌面端更多音源（波点音乐、YouTube Music、Spotify、汽水音乐），或翻一翻 deploy/docker/ 的完整部署文档。

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