Folia 下载安装全平台教程:Windows、macOS、Linux 一次跑通
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
Folia 是一款把歌词渲染成全屏动画的音乐播放器,桌面版支持网易云、酷狗、Navidrome 与本地音乐库。这篇教程讲清 Folia 下载、安装到第一次成功启动的完整过程:取哪个包、跑哪条命令、出问题怎么办。跟做完,你就能在自己的系统上把 Folia 打开并看到主界面。
Folia 安装前,先对号入座
| 你的情况 | 看哪一章 |
|---|---|
| Windows,或 Apple silicon Mac | 在 Windows 和 Apple silicon Mac 上装好 Folia |
| Intel Mac | macOS 章节的 Intel Mac 小节 |
| Arch 及 Arch 系发行版 | Arch 一条命令安装 Folia |
| Debian / Ubuntu / Fedora 等其他发行版 | Folia Linux 便携版部署 |
在 Windows 和 Apple silicon Mac 上装好 Folia
仓库的 README.md 里有「快速下载」一节,列了夸克网盘和百度网盘两个镜像链接,百度提取码是 flia。Windows 取 .exe 安装包,Apple silicon Mac 取 .dmg。
⚠️ 网盘里只有 Windows 与 Apple silicon 两种安装包,Intel Mac 和 Linux 都不在里面;而且网盘版本可能落后于最新 release,下载前先把版本号对一下。
拿到包之后:
- Windows 直接双击 .exe,按提示走完;macOS 把 .dmg 拖进 Applications。
- 在开始菜单或应用列表里找到 Folia 并打开。
- 能看到主界面,就说明 Folia 安装完成了。
Intel Mac:直接去 Releases 取 dmg
Intel Mac 在网盘里没有任何对应包,这一步别纠结。直接打开 Releases 页面下载 dmg,双击安装,流程和上面一致。
Linux 上安装 Folia
Arch 一条命令安装 Folia
先确认 AUR 助手可用,比如执行yay --version看看有没有反应,然后跑这一条:
yay -S folia-major-bin用 paru 的话,换成paru -S folia-major-bin即可。
这个 AUR 包做的事很直白:从 Releases 拉 linux-x64 的 tar.gz,解压装到 /opt/folia-major,再在 /usr/bin 下建一个 folia-major 软链接。依赖只有 alsa-lib、gtk3、libxss、nss 四项,当前版本是 0.1.4,都可以到 packaging/aur/folia-major-bin/PKGBUILD 里核对。
⚠️ 如果 AUR 构建卡在从 Releases 下载那一步,多半是网络的问题,直接改走下面的便携版方案。
Folia Linux 便携版部署
Debian、Ubuntu、Fedora 等发行版没有官方软件包,官方思路是便携版:整套程序解压在一个目录里,放在哪都由你定。
- 从 Releases 页面下载
folia-major-0.1.4-linux-x64.tar.gz。 - 解压到一个固定目录,这里以 ~/Apps/Folia 为例:
tar -xzf folia-major-0.1.4-linux-x64.tar.gz -C ~/Apps/Folia- 把
resources/linux/folia-major.desktop复制到~/.local/share/applications/。 - 打开复制出来的 .desktop 文件,将
__APP_PATH__换成 folia-major 可执行文件的绝对路径,__ICON_PATH__换成resources/linux/icon.png的绝对路径。 - 如果桌面环境要求应用「可信」(GNOME 常见),给这个 .desktop 文件标记为可信,然后从应用菜单启动 Folia。
Folia 黑屏解决:启动失败排查
| 症状 | 处理办法 |
|---|---|
| Linux 启动后黑屏、透明度或模糊异常、直接崩溃 | 改用FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major强制软件渲染 |
| swiftshader 下仍不稳定 | 换更保守的FOLIA_LINUX_GRAPHICS_MODE=software |
| 网盘里找不到 Intel Mac 或 Linux 的包 | 回 Releases 页面按平台取对应安装包 |
| AUR 构建卡在下载步骤 | 放弃 AUR,改走便携版手动部署 |
| 网盘链接失效或版本过旧 | 以 README「快速下载」一节的最新链接为准 |
| 部署完桌面快捷方式不显示 | 检查 .desktop 的 Exec 与 Icon 是否为绝对路径,并确认已标记可信 |
装完之后,还能往哪走
打开本地库或任一在线音源,全屏歌词动画就能跑起来了。想深入看 Linux 图形模式、Wayland / Hyprland 下的遥控窗等桌面端细节,读 docs/technical.md;想把 Web 版本用 Docker Compose 拉起来,看 deploy/docker/README.md。🎵
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考