Folia 下载与安装完整指南：5 分钟装好全屏歌词动画播放器

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

Folia 是以全屏歌词动画为核心的多音源音乐播放器。最省事的路线是官方网盘镜像：Windows 与 macOS 约 5 分钟完成 Folia 下载与安装；Linux 走便携包或 AUR，约 10 分钟。下文按安装路线分节，对号入座即可。

先选路线：网盘镜像、Linux 便携版与 AUR 怎么选

多数人首选网盘镜像：不限速、步骤最少，双击安装包就走完流程。

网盘镜像：Windows 与 macOS 首选路线

前置条件：

• 系统为 Windows，或 Apple silicon 的 macOS
• 已注册夸克网盘或百度网盘账号，并登录对应客户端
• 硬盘留有足够空间存放安装包

动作步骤：

1. 打开 README.md，找到「快速下载」小节，这里有两个官方网盘入口：夸克网盘与百度网盘（提取码flia）。完成后：入口链接与提取码已就位。
2. 用网盘客户端登录，先把安装包转存到自己的网盘，再开始下载。完成后：下载按网盘正常速度进行，不限速、不断流。
3. 按系统选文件：Windows 拿.exe，macOS 拿.dmg，双击后跟着向导走。完成后：开始菜单或 Launchpad 里出现 Folia 图标。
4. 如果网盘版本落后于最新版，就到官方 Releases 页面核对版本号后再继续。完成后：版本号与页面一致，即可正常使用。

⚠️ 只使用 README「快速下载」给出的官方网盘入口，勿下载来路不明的第三方转发包。

解压即用：Linux 便携版

前置条件：

• 非 Arch 的 Linux 桌面系统
• 能下载并解压.tar.gz压缩包
• 知道桌面启动项目录位置（默认~/.local/share/applications）

动作步骤：

1. 从官方 Releases 页面下载folia-major-<版本>-linux-x64.tar.gz，版本号以页面显示为准。完成后：压缩包完整落地。
2. 解压到任意固定目录，后续不要随意移动。完成后：目录内有folia-major可执行文件与resources目录。
3. 双击或运行目录内的folia-major。完成后：Folia 窗口正常弹出。
4. 可选：把模板启动项复制到用户级应用目录，再替换文件里的__APP_PATH__与__ICON_PATH__占位符，详见 packaging/linux/README-LINUX.txt。完成后：应用菜单出现 Folia 启动项。

# 把便携包内的桌面启动项模板复制到用户级应用目录 cp resources/linux/folia-major.desktop ~/.local/share/applications/folia-major.desktop

一条命令安装：Arch Linux AUR

前置条件：

• Arch Linux 系统
• 已安装 yay 等 AUR Helper

动作步骤：

1. 确认 AUR Helper 可用。完成后：yay --version正常返回版本号。
2. 执行安装命令，构建会自动拉取官方便携 tar.gz，并装好alsa-lib、gtk3、libxss、nss等依赖，定义见 packaging/aur/folia-major-bin/PKGBUILD。完成后：终端完成构建安装，应用菜单出现 Folia 图标。

# 一条命令安装 folia-major-bin，依赖由 yay 自动处理 yay -S folia-major-bin

README 另列出社区提供的 Flatpak 与 Android 移植，均为第三方项目，功能与官方 PC 版存在差异，以 README「获取方式」小节为准。

装完怎么算成功：30 秒验收清单

• ✅ 能启动：从开始菜单 / 应用菜单启动，窗口弹出且无黑屏，透明度正常；便携版在解压目录执行./folia-major，窗口弹出即通过
• ✅ 能正常使用：搜索并播放任意歌曲，全屏歌词动画与封面加载正常
• ✅ 版本号对得上：AUR 安装执行下面命令，输出包含folia-major-bin条目，版本号与 AUR 页面一致

# 核对已安装的 folia-major-bin 条目与版本号 pacman -Qs folia-major-bin

遇到问题看这里

• 启动后黑屏、模糊或透明度异常？GPU 渲染兼容问题。改用软件渲染模式启动：

# swiftshader 为软件渲染，绕过显卡兼容问题 FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major

• 网盘里的版本和最新版对不上？镜像更新有延迟。以 README「快速下载」入口为准，到 Releases 页面核对版本号。

• AUR 构建卡在拉包？拉取官方 tar.gz 的网络较慢。手动放一份同版本folia-major-<版本>-linux-x64.tar.gz进构建源码目录，再执行makepkg -si；仍不行就退回 Linux 便携版完成 Folia 安装。

• 桌面启动项没出现？占位符没替换。检查.desktop文件里的__APP_PATH__与__ICON_PATH__是否为绝对路径，桌面环境有要求时把文件标记为可信。

装完先到设置里接入本地音乐库或在线音源，再挑一个喜欢的全屏歌词动画主题。技术细节详见 docs/technical.md 🎵

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