Folia 全屏歌词播放器完整安装指南：10 分钟拿到一块会动的歌词舞台

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

Folia 是一款全屏沉浸式歌词播放器，接入网易云、酷狗、QQ 音乐、Navidrome 等在线音源，也支持本地曲库。本文带你走完选包、安装、启动全程，约 10 分钟。成功标准先定好：版本号对得上，播放中的歌有歌词动画占住整块屏幕。

如何选对发行包

动手前先回答三个问题：

• 系统是什么：Windows 64 位、macOS 的 M 系列还是 Intel 芯片、还是 Linux。芯片型号选错，结局是装完打不开，先确认再下载。
• 走哪条网络：直连 GitHub 慢就走网盘镜像，稳就直连 Releases 页，网盘入口见 README.md「快速下载」一节。
• 版本新不新：下完后把文件名里的版本号与 Releases 页最新值比对，对不上就先别装。

💡 网盘镜像（夸克、百度，提取码flia）只覆盖 Windows 与 Apple silicon 的正式版，表里其余行回 Releases 页取包。

从安装包到主界面：三个连续动作

安装包到手

目标：把系统对应的那个版本安装包下载完整。

• 选渠道：直连 GitHub 慢就走夸克或百度网盘（提取码flia），网盘只有 Windows 与 Apple silicon 正式版；否则直接上 Releases 页。
• 看名字：Windows 认准.exe后缀；macOS 上 Apple silicon 认准arm64、Intel 认准x64，后缀是.dmg；Linux 认准linux-x64，格式 tar.gz、deb、rpm 均可。
• 核版本：文件名里的版本号与 Releases 页最新值对一下，不一致就等同步或改走直连，别装一个错位版本。
• 防中断：网盘下载先转存到自己网盘再取回，中途断了能续传。

判断这步做对没有：打开文件名逐字看一遍，平台标识、版本号两样齐全。

程序就位

目标：让 Folia 出现在系统的应用列表里，全程不用预装 Node.js 或任何开发工具，安装程序已打包全部运行环境。

• Windows 装：双击.exe，向导一路点完，装到默认位置即可。
• macOS 装：打开.dmg，把 Folia 图标拖进 Applications 文件夹；首次启动按系统提示确认。
• Arch 装：终端执行下方命令，这个 AUR 包自动处理alsa-lib、gtk3、nss等依赖，把程序装进/opt/folia-major，并在应用菜单生成启动项。
• 其他 Linux 装：把.tar.gz解压到任意目录即可，无需再安装。

yay -S folia-major-bin

💡 AUR 构建阶段下载慢时，可先从网盘下好同版本 tar.gz 放进 AUR 源码目录，再执行makepkg -si。

判断这步做对没有：开始菜单、应用程序文件夹或应用菜单里能找到 Folia 的入口。

主界面出现

目标：打开应用，进入主界面，放出第一首带歌词的歌。

• 启动：Windows 上开始菜单双击 Folia；macOS 上从应用程序文件夹打开；Arch 上应用菜单里双击 folia-major；其他 Linux 上终端执行下方命令。
• 播放：主界面出现后，登录任一在线音源，或导入一个本地文件夹，挑一首带歌词的歌播放。
• 放快捷方式（可选）：复制包内resources/linux/folia-major.desktop模板到~/.local/share/applications/，把其中__APP_PATH__、__ICON_PATH__两个占位符换成实际路径，细节见 packaging/linux/README-LINUX.txt。

./folia-major

判断这步做对没有：歌曲播放后，歌词动画接管整个屏幕。

怎么判断装成功了

1. 版本号：「关于」页里的版本号与刚下的包一致，对得上就算装对了。
2. 最小体验：登录任一在线音源或导入本地文件夹，播放一首带歌词的歌，确认全屏歌词动画自动播起来。

调一调屏幕：三个功能入口

• 换主题：「设置」里把歌词主题挨个看一遍，「浮名」和「流光」是两种视觉语言，切换对比只要 30 秒——入口：设置。

• 导曲库：选一个本地文件夹导入，本地歌曲自动匹配在线歌词与封面，不用手动找.lrc——入口：本地音乐库，用法见 docs/local-library-management.md。
• 壁纸模式：用 Wayland（niri、KWin、Hyprland 等合成器，GNOME 除外）时，在「选项 → 桌面端」打开「壁纸模式」开关，整个窗口沉到全部普通窗口下面，歌词直接显示在桌面上——入口：选项 → 桌面端。

排障速查：按症状对号入座

FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major

仍不稳定就把取值换成software，稳定后再切回system恢复系统图形路径，变量完整说明见 packaging/linux/README-LINUX.txt。

版本号对得上、播放中的歌有歌词在整块屏幕上动起来，整条安装链路就闭环了。下一步去「设置」里换个主题，把这块屏幕调成自己的样子。

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