Folia 安装指南：快速上手全屏歌词播放器（Windows / macOS / Linux）

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

Folia 是一个把歌词做成全屏沉浸式动画的音乐播放器，支持网易云、QQ 音乐、酷狗在线音源，也可以接入 Navidrome 和本地音乐库。这份 Folia 安装教程覆盖 Windows、macOS、Linux 三端，照着做，十分钟之内你就能放歌、看全屏歌词。

桌面版把前后端运行环境都打进了安装包，装完即用，不需要 Node.js，也不需要任何开发工具。

10 秒选包

网盘镜像并不覆盖全部平台，Intel Mac 和 Linux 只能走 Releases。

三步装完

第 1 步：选对包，下载完再核对版本

按上表找到对应文件，下载完成先对版本号：文件名里标的版本要和 Releases 页最新标注一致，对不上就等镜像同步，或者直接改走 Releases 重新下。到这里没有版本出入，这一步才算走完。

第 2 步：按系统完成安装

• Windows：双击 .exe，安装向导逐步走完即可。
• macOS：打开 .dmg，把 Folia 拖进 Applications 文件夹。
• Linux：把 .tar.gz 解压到任意目录，直接运行里面的可执行文件。

Windows 在开始菜单、macOS 在启动台里能看到 Folia 图标，就说明装到了位。Linux 桌面启动项的配法写在 README-LINUX.txt：把模板复制到~/.local/share/applications/，再把__APP_PATH__、__ICON_PATH__两个占位符换成实际绝对路径，按桌面环境要求标记可信。

第 3 步：启动并验证

首次启动后，登录一个在线音源，或导入一个本地文件夹；随便播一首带歌词的歌，屏幕被歌词动画铺满，说明装到位了。

特别路线

Folia AUR 安装（Arch 发行版）

Arch 用户不用手动下包，一条命令装完：

yay -S folia-major-bin

paru 用户把yay换成paru即可。依赖项会自动解决，程序装到/opt/folia-major，应用菜单里出现 Folia 且能点开，这步就完成了。

本地构建的替代做法

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

Folia Web 版部署（NAS / 浏览器 / 手机）

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

收工前核对

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

四项都对上，就可以开始日常使用了。

常见问题

Q：下载总是断怎么办？

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

Q：Linux 启动黑屏或闪退？

A：多半是 GPU 兼容问题，不是装坏了。先怀疑显卡兼容，用FOLIA_LINUX_GRAPHICS_MODE=swiftshader以软件渲染模式启动验证；仍不稳定就切到更保守的software模式；确认是显卡问题后，可以再用system值恢复系统图形路径。

Q：拿错包了怎么办？

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

核对完「关于」页的版本号，挑一首带歌词的歌，让整块屏幕亮起来。

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