Folia 全屏歌词播放器快速安装指南：Windows、macOS、Linux 三端十分钟完整装好

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

Folia 是一个把歌曲唱成全屏沉浸式动画的全屏歌词播放器，支持网易云、QQ 音乐、酷狗在线音源，也能接入 Navidrome 和本地音乐库。这份 Folia 安装教程照着做，十分钟左右你就能看到带歌词的歌把整块屏幕铺满。

装前确认：选对包和下载渠道

网盘镜像不覆盖全部平台：Intel Mac 和 Linux 的包没有镜像，只能走 Releases 页。下完先核对文件名里的版本号和 Releases 页最新标注，对上了这一步才算走完。

分系统安装：Windows、macOS、Linux 一次装完

Windows 安装步骤：双击安装包走完向导

取 64 位的 .exe。双击安装程序，向导一路走完。证据：开始菜单出现 Folia，点开能进主界面。

macOS DMG 安装：拖进 Applications

取对应芯片的 .dmg（Apple silicon 或 Intel）。打开 DMG，把 Folia 拖进 Applications 文件夹。证据：启动台出现 Folia，双击能打开主界面。

Linux 解压运行 tar.gz 包

取对应 CPU 架构的 .tar.gz，x86_64 和 ARM 互不通用。解压到任意目录，直接运行里面的folia-major可执行文件。证据：主窗口正常弹出。桌面启动项的配法在 packaging/linux/README-LINUX.txt：把模板复制到~/.local/share/applications/，再把__APP_PATH__、__ICON_PATH__两个占位符换成实际绝对路径。

启动验证：点亮全屏歌词

两个最小动作：登录一个在线音源，或导入一个本地文件夹；然后挑一首带歌词的歌播放。

主界面正常显示歌单和搜索后，点开一首带歌词的歌，整块屏幕被歌词动画铺满，就算过关。再切两三个主题，排版保持正常。

替代路线：AUR、NAS Web 版、本地构建加速

Arch 用户，一条命令装完

yay -S folia-major-bin

paru 用户把yay换成paru。程序装到 /opt/folia-major，应用菜单出现 Folia 且能点开即完成。依赖清单和安装位置写在 PKGBUILD，想核对就看这个文件。

NAS、浏览器、手机：部署 Web 版

不想装桌面端，就把项目部署到 Vercel、Cloudflare 或 Docker，浏览器里直接听；页面添加为 PWA 后手机上也能当 App 用。这条路线适合 NAS 和移动场景，完整步骤在 deploy/docker/README.md。

本地构建加速

构建阶段拉压缩包太慢，可以先用网盘下好同版本的 Linux .tar.gz，放进 AUR 源码目录，再执行makepkg -si。下载地址就写在 PKGBUILD 里。

验收清单：收工前核对四项

• 🏷️ 版本一致：「关于」页版本号和安装包文件名里的版本一致
• 🔑 音源可用：成功登录一个在线音源，或导入本地文件夹、接入 Navidrome
• 🎤 歌词动画：播放带歌词的歌，全屏动画正常亮起
• 🎨 主题可切换：切换两三个主题，排版不乱

四项全部对上，即可开始日常使用。

疑难解答：三个常见卡点快速判断

Q：下载总是断怎么办？

国内网络直连 Releases 容易慢或断流。优先换官方网盘镜像（夸克、百度），取回后核对一遍版本。镜像只覆盖 Windows 和 Apple silicon 的正式版，Linux 的 .tar.gz 没有镜像，只能走 Releases。

Q：Linux 启动黑屏或闪退？

多半是 GPU 兼容问题，不是装坏了。先用FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major以软件渲染启动验证；仍不稳定就切更保守的FOLIA_LINUX_GRAPHICS_MODE=software。图形模式细节见 packaging/linux/README-LINUX.txt。

Q：拿错包了怎么办？

拿错包基本两类：Intel Mac 装了 Apple silicon 版本，或 Linux 下错了 CPU 架构。文件名都带平台标识，回 Releases 页逐字比对一次，重新下载即可。

挑一首带歌词的歌，让整块屏幕亮起来。

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