Folia 安装指南:Windows / macOS / Linux 从下载到启动
项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major Folia 是把歌词渲染成全屏动画的开源音乐播放器。本文只讲 Folia 安装:Windows 与 macOS 装现成安装包,Arch 走 AUR,其他 Linux 发行版手动部署,附装完验证与黑屏排查。
下载 Folia 安装包:官方 Releases 与网盘镜像怎么选
Folia 安装包统一放在项目的 Releases 页面。直连 GitHub 慢或频繁掉线时,转去 README「直接下载」 一节,那里有夸克网盘与百度网盘两个镜像,百度提取码 flia。
先对照下边这张表确认你的系统该取什么:
| 你的系统 | Releases 里取 | 网盘镜像有无 |
|---|---|---|
| Windows | .exe 安装包 | 有 |
| macOS(Apple silicon) | .dmg 安装包 | 有 |
| macOS(Intel) | .dmg 安装包 | 无,回 Releases 取 |
| Linux | .deb / .rpm / linux-x64 的 tar.gz | 无,回 Releases 取 |
下之前核对两件事:
- 网盘镜像只覆盖 Windows 与 Apple silicon 两个正式版安装包,Intel Mac 和 Linux 不在其中。
- 网盘里的版本会滞后于最新 release,下载后先对一眼版本号再装。
Windows 与 macOS 安装 Folia:选包、安装、打开三步走
桌面版内置了前后端运行环境,装完即用,不需要 Node.js,也不需要额外装任何依赖。
- 选对包:Windows 取
.exe;macOS 取.dmg,Apple silicon 的机器注意选对应架构的版本。 - 安装:运行安装包,按提示走完即可,全程无额外依赖。
- 打开确认:启动应用,确认主界面正常加载、能搜到歌,安装就算完成。
Linux 安装 Folia:AUR 命令与便携版部署两条路
Arch / Manjaro:Folia AUR 安装一行命令
yay 或 paru 装好后执行:
yay -S folia-major-bin # 用 paru 时命令相同
这个 AUR 包做的事很简单:构建时去 Releases 拉取 folia-major-<版本>-linux-x64.tar.gz,整体放进 /opt/folia-major,再建一个 usr/bin/folia-major 的链接。当前包版本 0.1.4,依赖清单(alsa-lib、gtk3、libxss、nss)都能在 PKGBUILD 里逐项核对。
一个提示:如果构建长时间卡在下载步骤,那就是「国内访问 GitHub 慢」的同一个网络问题。挂着等没有意义,直接转下面的手动部署路线。
其他发行版:手动部署 .deb / .rpm / tar.gz
Debian / Ubuntu 取 .deb 包,Fedora / RHEL 系取 .rpm,都不合适就取 linux-x64 的 tar.gz 解压使用。便携包里就三样东西:
folia-major可执行文件resources/linux/icon.png应用图标resources/linux/folia-major.desktop桌面启动项模板
想让它出现在应用菜单里,按顺序做:
- 把桌面模板复制到
~/.local/share/applications/folia-major.desktop。 - 替换复制出的文件里的两个占位符:
__APP_PATH__改成可执行文件的绝对路径,__ICON_PATH__改成图标的绝对路径。 - 桌面环境若要求,把该文件标记为可信或可执行。
完整示例见 packaging/linux/README-LINUX.txt。
装完 Folia 后的快速验证:放一首逐字歌词的歌
安装流程走完不等于装好了。放一首带逐字歌词的歌,全屏歌词动画能正常动起来,说明 Folia 安装到位。
Linux 下如果一启动就黑屏、透明度或模糊异常,不用逐项自查,直接跳到下一节的渲染参数,两条命令就能定位问题。
Folia 故障排查:黑屏、卡下载、镜像失效怎么处理
按序号对号入座:
- Linux 启动黑屏、透明度或模糊异常 → 先换软件渲染:
FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major - swiftshader 下仍闪烁不稳 → 退到最保守的软件渲染:
FOLIA_LINUX_GRAPHICS_MODE=software ./folia-major - AUR 构建卡在下载步骤 → 别挂着等,改走便携版手动部署
- 网盘链接失效或版本过旧 → 以 README「直接下载」一节的最新链接为准,并核对版本号
- 网盘里没有你要的平台包(Intel Mac / Linux)→ 回 Releases 页面直接取对应平台包
补充说明:FOLIA_LINUX_GRAPHICS_MODE 只改变 Electron 在 Linux 上的启动参数,不影响 Web 端与同步服务;排查渲染问题前,先确认可执行文件和 resources/ 仍在同一个便携包目录里。
延伸阅读:Folia 技术文档、Docker 自托管与本地库管理
- 桌面项细节、Wayland 壁纸模式、遥控窗配置:docs/technical.md
- 想在手机或浏览器里用:自托管 Web 版本,Docker Compose 全栈方案见 deploy/docker/README.md
- 本地音乐库的导入、重扫与在线匹配:docs/local-library-management.md
装好之后,下一步去登录页连上网易云、QQ 音乐这类音源,或把本地文件夹导进音乐库,给动画找点内容。🎧
转载自 CSDN-专业IT技术社区
原文链接：https://blog.csdn.net/gitblog_00640/article/details/167272716
