Folia 安装教程：3条路线 15分钟跑起全屏歌词动画播放器

Folia 安装教程：3 条路线 15 分钟跑起全屏歌词动画播放器

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

项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major

Folia 是一款以全屏沉浸式歌词动画为核心的开源音乐播放器，支持本地音乐库以及网易云、酷狗、QQ 音乐、Navidrome 等在线平台，能自动匹配歌词并用 AI 生成配色主题。本文覆盖网盘镜像、Linux 便携压缩包、Arch AUR 三条安装路线，全程预计 10~20 分钟，跟着做即可从零跑起全屏歌词界面。

路线总览

路线适用环境预计耗时是否需要命令行下载/安装入口网盘镜像双击安装Windows、macOS（Apple silicon）约 10 分钟不需要官方网盘镜像，入口见 README「快速下载」Linux 便携压缩包除 Arch 外的 Linux 发行版约 15 分钟少量（仅可选步骤）Releases 页的 folia-major-<版本>-linux-x64.tar.gzAUR 包管理器安装Arch Linux约 20 分钟需要AUR 包 folia-major-bin，构建脚本见 PKGBUILD

三个问题选对路线

你的系统是 Windows、macOS 还是 Linux？ 如果你用 Windows 或 Apple silicon 的 Mac，就走网盘镜像路线，全程双击完成；如果是 Arch Linux，直接走 AUR 路线，一条命令到位；其余 Linux 发行版（Debian、Ubuntu、Fedora 等）走便携压缩包路线。+ 你的网络能顺畅打开官方 Releases 页吗？ 能，就按对应路线正常下载；不能或明显很慢，且你是 Windows / macOS 用户，就改用官方网盘镜像，先转存再下载更稳。+ 你习惯用命令行吗？ 习惯就用 AUR 路线，步骤最短；不习惯就选网盘双击或压缩包解压路线，命令行只在可选项里出现。

网盘镜像安装路线（Windows / macOS）

打开仓库 README.md，在「快速下载」小节找到官方夸克网盘与百度网盘入口（百度网盘提取码 flia）。确认：入口页面能正常打开。 + 登录网盘，把安装包先转存到自己的网盘，再开始下载。确认：下载完整、过程不中断。

⚠️ 只从 README「快速下载」的官方入口拿包，不要用来路不明的转发包，避免植入风险。

双击 .exe 安装包（Windows）或 Apple silicon 的 .dmg（macOS），按向导装完。看到开始菜单或 Launchpad 里的 Folia 图标即通过。

启动 Folia，播放任意一首歌。看到全屏歌词动画随音乐动起来即通过。

Linux 便携压缩包路线（除 Arch 外的 Linux）

打开官方 Releases 页，下载 folia-major-<版本>-linux-x64.tar.gz，版本号以 README 为准。确认：文件下载完整。 + 解压压缩包到一个固定目录（如 ~/Apps/Folia），后续升级都在这个目录操作。确认：目录里同时有 folia-major 可执行文件和 resources/ 目录。 + 双击目录里的 folia-major 启动。看到应用窗口弹出即通过；如果双击没反应，通常是缺执行权限，在该目录执行 chmod +x folia-major 后重试。

⚠️ 便携包要求可执行文件与 resources/ 位于同一目录，不要把两者拆开存放。

（可选）复制 resources/linux/folia-major.desktop 到 ~/.local/share/applications/，再把文件里的 __APP_PATH__、__ICON_PATH__ 占位符改成实际绝对路径，具体改法见 packaging/linux/README-LINUX.txt。确认：应用菜单出现 Folia 项。

AUR 一条命令路线（Arch Linux）

安装 AUR Helper（已有 yay 或 paru 的可跳过）。确认：yay --version 或 paru --version 能输出版本号。 + 执行安装（习惯用 paru 的把命令里的 yay 换成 paru）：

1	yay -S folia-major-bin

构建会从 Releases 拉取 Linux 便携压缩包，alsa-lib、gtk3、nss 等依赖自动装好，拉取耗时较长属正常现象。确认：构建结束无报错，程序落在 /opt/folia-major。 + 执行 pacman -Qs folia-major 检查。看到 folia-major-bin 条目，且应用菜单出现 Folia 启动项即通过。

出问题先查这张表

现象可能原因处理办法Linux 启动黑屏、透明度或模糊异常显卡渲染兼容问题用软件渲染模式启动，命令见下方代码块AUR 构建长时间卡在下载压缩包Releases 拉取速度慢提前备好同版本 tar.gz，放进构建源码目录后执行 makepkg -si网盘版本和最新版对不上网盘镜像更新有延迟以 README「快速下载」入口为准，到 Releases 页核对版本号双击 folia-major 没反应可执行文件缺执行权限在解压目录执行 chmod +x folia-major 后重试

图形渲染问题的两条常用命令：