Folia 全屏歌词播放器安装指南：三端选对包，10 分钟开听

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

Folia 是一款把歌词做成全屏沉浸式动画的全屏歌词播放器，支持网易云、酷狗、QQ 音乐、Navidrome 与本地曲库，桌面端还额外接入波点音乐、YouTube Music 和 Spotify。这篇 Folia 安装教程写给第一次装这类桌面应用的新手：认准系统挑对安装包，全程约 10 分钟装完开听。

先选路线

⏱ 桌面版安装程序自带全部运行环境，无需预装 Node.js 等任何开发工具。先判断你的机器属于下面哪条路线，并对照「自查项」确认一次：

下载与选包：两个渠道一条规则

• GitHub Releases：全平台覆盖的唯一渠道，Windows、macOS、Linux 的包都从这里取；国内直连可能偏慢或断流，但版本永远是最新。
• 官方网盘镜像（夸克、百度，百度提取码flia）：入口在 README.md 的「快速下载」一节，对国内网络更友好，但只提供 Windows 与 Apple silicon 的正式版安装包。

💡只有一条规则：下载前先核对文件名里的版本号与发布页标注的最新值是否一致。网盘镜像偶尔会晚一步，对不上就先等同步，或直接改走另一渠道。

安装步骤

Windows 安装：向导式装完

1. 选包：从 README「快速下载」入口或 Releases 页面，挑文件名带 Windows 平台标识的.exe。
2. 核对：扫一眼文件名版本号与最新发布是否一致；网盘落后就改走 Releases。
3. 落盘：走网盘渠道时，建议先转存到自己的网盘再取回，中途断了可续传。
4. 跑完：双击.exe安装程序，按向导提示一路到底。
5. 启动：在开始菜单里找到 Folia 并打开，即进入主界面。

macOS 安装：拖入 Applications

1. 选包：Apple silicon 机器选 Apple silicon 版.dmg；Intel 芯片的 Mac 回 Releases 页面找 Intel 版。
2. 核对：文件名版本号与最新发布对上后再下载，对不上先缓一缓。
3. 落盘：打开.dmg镜像，把 Folia 应用拖进 Applications 文件夹。
4. 启动：首次启动按系统安全提示确认一次即可正常打开。

Arch Linux 安装：一条命令装完

1. 选包：确认机器上已有 AUR Helper（yay 或 paru 均可）。

2. 跑起：终端执行

   # 从 AUR 安装预构建包，paru 用户把 yay 换成 paru yay -S folia-major-bin

   包会自动解析alsa-lib、gtk3、libxss、nss等依赖，把程序装进/opt/folia-major并生成应用菜单项，完整定义可查 PKGBUILD。

3. 核对：若从 AUR 拉压缩包太慢，可先在网盘下好同版本的folia-major-<版本号>-linux-x64.tar.gz放进 AUR 源码目录，再执行makepkg -si完成构建。

4. 启动：从应用菜单直接打开。

其他 Linux 安装：解压即跑

1. 选包：从 Releases 页面下载对应架构的.tar.gz，x86_64 与 ARM 的包不通用。

2. 落盘：解压到任意目录。

3. 跑起：在终端执行

   # 直接启动 Folia 主界面 ./folia-major

4. 开启：需要桌面入口的话，把包内resources/linux/folia-major.desktop模板复制到~/.local/share/applications/，按 README-LINUX.txt 把__APP_PATH__、__ICON_PATH__两个占位符替换成实际路径，桌面环境有限制时再把文件标记为可信，应用菜单里就有它了。

自托管：Web / NAS / 手机

想在浏览器、NAS 或手机里听，走 Web 版本。云端平台的一键部署入口见 README.md 的「获取方式」一节；自托管用户参考 deploy/docker/ 的 Docker Compose 全栈说明，要求 Docker Engine 24+ 与 Compose v2，部署后在浏览器里添加为 PWA 即可当 App 用。这条路线门槛高、耗时以半小时计，新手不建议从这里起步。

装完验收

30 秒确认两件事，都过了才算装好：

1. 版本对账：进入「关于」页面，核对版本号与刚下载的包一致——一致是安装成功的第一个标志。
2. 最小体验：登录一个在线音源，或导入一个本地文件夹，播放一首带歌词的歌。通过标准：全屏歌词动画自动亮起来。

装好后的头 5 分钟

• 主题换着看：进设置切换主题，每套的歌词排版氛围不同，「流光」和「浮名」是两种完全不同的视觉语言，切两三个只要 30 秒。
• 导入本地曲库：选中一个本地文件夹导入后，在线歌词与封面会自动匹配，不必再手动找.lrc。
• 桌面歌词壁纸：Wayland 下（niri、KWin、Hyprland 等支持wlr-layer-shell的合成器，GNOME 除外），在「选项 → 桌面端」开启「壁纸模式」，窗口会沉到所有正常窗口之下，歌词动画直接在桌面上播放。

问题速查表

三种图形模式用法相同，仅替换变量值：

# 以软件渲染模式启动，验证是否 GPU 兼容问题 FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major

# 仍不稳定时，换成最保守的 software 模式 FOLIA_LINUX_GRAPHICS_MODE=software ./folia-major

# 稳定之后，用 system 值恢复系统图形路径 FOLIA_LINUX_GRAPHICS_MODE=system ./folia-major

这些变量的完整说明在packaging/linux/README-LINUX.txt里。

按「先选路线」表挑一条路，走完选包、核对、安装、启动这 10 分钟——第一首歌的歌词，已经会铺满你的整块屏幕。

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