Folia 全屏歌词播放器安装教程：三步让歌词点亮整块屏幕

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

Folia 是一个全屏歌词播放器：它播网易云、QQ 音乐、酷狗、Navidrome，也播你本地文件夹，放歌时歌词动画占满整块屏幕。本文的目标是：十分钟内装好、放出第一首歌、看全屏歌词亮起来，全程不用看一行代码。

🎬 先说目标：你会得到什么

是舞台，不是播放器：Folia 把歌词当主角。放一首歌，文字逐字逐行动起来，排版自动跟着窗口尺寸走，效果接近文字 PV。大致长这样：

🧭 选路线：先回答两个问题

放哪：PC、Mac 用桌面版最直接，装完即用；NAS、手机走 Web 版，部署后把网页加到主屏幕，当 PWA 用。

下什么：桌面版三个系统都有官方包——Windows 是.exe，macOS 是.dmg，Linux 是.tar.gz，Arch 另有 AUR。注意 Mac 的 M 系列与 Intel 是两套不同的包，按芯片选。

⚠️ 官方网盘镜像只收录 Windows 与 Apple silicon 两个包，Intel Mac 和 Linux 包只能从 Releases 页取。

Folia 的歌词舞台支持多种动画主题，登录后进首页就是这种感觉：

🚀 逐步安装

关键一步：不用预装任何依赖，桌面版自带前后端运行环境，选对平台路径走完就行。

Windows 安装：最省事的路径

1. 下：Releases 页取最新 Windows.exe，或直接看网盘镜像。
2. 装：双击.exe，向导一路下一步。
3. 开：开始菜单找到 Folia 启动，登录任一个音源（网易云、QQ 音乐、酷狗）。
4. 放：选一首带歌词的歌，全屏歌词动画自动亮起来。

⚠️ 桌面版已内置运行环境，不需要先装 Node.js 或任何开发工具。

macOS 安装：先认芯片再下包

点左上角苹果菜单 →「关于本机」看芯片：M 系列取 Apple silicon 版.dmg，Intel 取 Intel 版。双击.dmg，把应用图标拖进 Applications，拖完即装好。

⚠️ 首次启动提示「无法打开」是 Gatekeeper 拦了未识别应用，右键图标选「打开」，弹窗再确认一次即放行。

Linux 安装：Arch 一条命令，其他解压即跑

Arch / Manjaro 装了 yay 或 paru 的，一条命令：

yay -S folia-major-bin

这条命令从 AUR 拉预构建包，自动解决 alsa-lib、gtk3 等依赖，程序落进/opt/folia-major。其他发行版下对应架构的.tar.gz，解压后folia-major可执行文件直接能跑；想要应用菜单入口，把桌面项模板里的__APP_PATH__、__ICON_PATH__两个占位符替换成绝对路径即可，详见 packaging/linux/README-LINUX.txt。

⚠️ Linux 启动黑屏、透明度异常或闪退，多数是 GPU 兼容问题，先用软件渲染强制验证：

FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major

这条命令让 Folia 绕开显卡走软件渲染启动，能开就是显卡相关；确认后设FOLIA_LINUX_GRAPHICS_MODE=system恢复系统图形路径。

Web 版部署：把 Folia 放到 NAS 和手机上

Vercel、Cloudflare 的一键部署入口在 README.md「获取方式」一节；想自托管就按 deploy/docker/README.md 走 Docker Compose 全栈部署。站起来之后，浏览器把页面加到主屏幕就能当 PWA 用。

✅ 验收：两条都对就是装成了

版本号对得上：进「关于」页，版本号和你刚下的包一致。

歌词亮起来：放一首带歌词的歌，全屏歌词动画自动点亮。

两条都过，这次上手就成了。装好后进网易云音源首页，就是下面这个画面：

🌙 跑通之后：值得做的三件事

切主题：去设置里把歌词动画主题逐个过一遍，挑最合眼缘的留下。

喂自己的歌：本地曲库指向一个文件夹，Folia 会索引音频、自动读取同目录同名.lrc歌词，详细用法见 docs/local-library-management.md。

桌面变舞台：开启壁纸模式，整个窗口沉到所有窗口之下，桌面变成歌词屏。

更多部署与平台细节看 docs/technical.md。

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