Folia 全屏歌词播放器安装指南：3 条路线 5–15 分钟装好
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
从官方渠道下载 Folia 全屏歌词播放器的安装包，国内网络往往慢得让人放弃，渠道也只有 Releases 一个。这里换三条路线：网盘镜像、AUR 助手、便携版，Windows、macOS、Linux 都能覆盖，5–15 分钟装完即可播放。
Folia 是一款以全屏歌词动画为核心的音乐播放器，内置流光、浮名等多套动画主题，支持网易云、QQ 音乐、酷狗、Navidrome 与本地曲库。桌面版自带前后端运行环境，装完直接就能播；Windows、macOS、Linux 全平台覆盖，另有 Web 版和实验性的 Folium 模组系统，可以扩展歌词动画。
动手前：先核对版本再选路线
做三件小事，然后就可以动手：
- 按系统定路线：Windows 与 macOS（Apple silicon）走网盘镜像；Arch / Manjaro 等 AUR 系发行版走 AUR 助手；Debian / Ubuntu 等其他发行版走便携版 tar.gz。
- 核对版本号：仓库当前版本是0.7.23，打开仓库根目录的 package.json 即可确认。
- 镜像可能滞后：网盘镜像和 AUR 包版本落后于官方发布属正常现象，发现不一致时先到 Releases 页面比对最新版，再决定要不要替换。
路线对比：按平台选哪条
| 路线 | 适用平台 | 难度 | 耗时 | 前置条件 |
|---|---|---|---|---|
| 🚀 网盘镜像 | Windows / macOS（Apple silicon） | ★☆☆ | 约 5 分钟 | 已登录夸克或百度网盘 |
| 📦 AUR 助手 | Arch / Manjaro 等 AUR 系 | ★★☆ | 约 15 分钟 | 已安装 yay 或 paru |
| 🖥️ 便携版 tar.gz | Debian / Ubuntu 等其他发行版 | ★★☆ | 约 10 分钟 | 一个可自由放置程序的目录 |
三条路线互相独立，没有先后顺序，做和系统匹配的那条即可。
💡 你的发行版不在表里？直接选便携版 tar.gz，任何 Linux 发行版都能解压运行。
用网盘镜像拿 Windows 和 macOS 安装包
适用范围：Windows、macOS（Apple silicon）。网盘只同步 Windows 正式版.exe与 macOS Apple silicon 的.dmg，没有 Linux 包。
分步操作：
- 打开仓库 README.md 的「快速下载」一节，里面有夸克网盘与百度网盘两个官方入口（百度提取码
flia）。 - 登录夸克或百度客户端，把安装包转存到自己的网盘。
- 按平台挑文件：Windows 选
.exe，macOS 选.dmg，并确认是 Apple silicon 版本。 - 下载完成后双击安装，桌面版内置运行环境，无需额外配置。
完成判断：启动 Folia，切到一首带歌词的歌，全屏歌词动画正常播放就算成功。
⚠️ 只使用 README.md 内的官方网盘链接，不要下载来路不明的第三方转发包，避免装到恶意程序。
💡 网盘只同步正式版安装包，想体验 beta / alpha 通道请走 Releases 页面，详见「版本与更新通道」。
用 AUR 助手一条命令装好 Arch / Manjaro
适用范围：Arch Linux、Manjaro 等 AUR 系发行版。AUR 是 Arch 社区的第三方软件源，Folia 对应的包名是folia-major-bin。
分步操作：
- 确认系统装了
yay或paru等 AUR 助手。 - 执行安装命令：
yay -S folia-major-bin助手会解析alsa-lib、gtk3、libxss、nss等依赖并完成构建，应用落在/opt/folia-major，同时生成folia-major命令和系统菜单启动项，包定义细节见 PKGBUILD。
完成判断：终端输入folia-major回车，主界面弹出就算成功。
💡 构建卡在
folia-major-<版本>-linux-x64.tar.gz的下载上，通常是下载慢或 AUR 包版本落后于官方最新版导致 404。可以先拿到同版本的 tar.gz，按原文件名放进构建源码目录（srcdir），再执行makepkg -si跳过慢速下载。
在 Debian / Ubuntu 用便携版 tar.gz 解压即用
适用范围：Debian、Ubuntu、Linux Mint 等其他发行版。便携版是完整包，解压就是可运行的程序。
包内有三个关键文件：
folia-major：程序可执行文件resources/linux/folia-major.desktop：桌面启动项模板resources/linux/icon.png：应用图标
分步操作：
- 从仓库 Releases 页面最新版本下载
folia-major-<版本>-linux-x64.tar.gz。 - 把 tar.gz 解压到一个自选目录，例如
~/Apps/Folia。 - 把
.desktop模板复制到~/.local/share/applications/folia-major.desktop。 - 在复制后的文件里，把
__APP_PATH__与__ICON_PATH__两个占位符替换成可执行文件和图标的实际路径。 - 桌面环境有要求时，把启动项文件标记为可信或可执行。
完成判断：在解压目录运行下面的命令，主界面弹出就算部署成功。
./folia-major这条命令直接在解压目录启动 Folia。
⚠️ 网盘镜像里没有 Linux 包，tar.gz 必须从 Releases 页面下载。
版本与更新通道：去哪核对、beta 怎么拿
- 版本核对入口：仓库根目录的 package.json（同级的
realeco-release文件记录同一版本）当前为0.7.23，最新正式版以 Releases 页面为准。 - 三条更新通道：Realeco（正式版，
latest标签）、Limo（beta nightly）、Cielo（alpha canary），各通道的完整说明见 docs/technical.md 的「发布与更新通道」一节。 - 网盘只同步正式版：只有 Realeco 通道提供网盘下载，beta / alpha 包只能在 Releases 页面获取。
- 版本不一致怎么办：网盘文件、AUR 包版本与上面不一致时，先到 Releases 页面比对最新版，再决定是否覆盖替换。
常见问题：黑屏、404、启动项丢失
| 现象 | 原因与处理 |
|---|---|
| 启动后黑屏、透明度/模糊异常或 GPU 崩溃 | 图形驱动兼容问题。用软件渲染启动：FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major；仍不稳定改用software，恢复系统图形路径用system |
| AUR 构建卡在 tar.gz 下载或提示 404 | 下载慢或 AUR 包版本落后于官方最新版。先核对版本号，再把同版本 tar.gz 预拉取到构建源码目录（srcdir），然后执行makepkg -si |
| 装完应用菜单里没有启动项（便携版） | 依次核对三点：.desktop文件是否在~/.local/share/applications/、__APP_PATH__与__ICON_PATH__是否已替换、文件是否标记为可信或可执行 |
| 网盘里的版本比预期旧 | 镜像滞后于官方发布属正常现象。以 README.md「快速下载」一节的版本为准，到 Releases 页面比对后再决定是否覆盖替换 |
结尾
装完之后切一首带歌词的歌，剩下的时间交给音乐。
延伸阅读
- deploy/docker/README.md：用 Docker Compose 自托管 Web 版，手机浏览器直接听
- docs/technical.md：技术架构、Wayland / Hyprland 遥控窗细节与三条更新通道说明
- packaging/linux/README-LINUX.txt：便携版文件说明、启动项创建与 Linux 图形开关
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
