☰
Folia 下载安装全平台教程:Windows、macOS、Linux 一次跑通
2026/10/25 1:49:44 网站建设 项目流程

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 MacmacOS 章节的 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,下载前先把版本号对一下。

拿到包之后:

  1. Windows 直接双击 .exe,按提示走完;macOS 把 .dmg 拖进 Applications。
  2. 在开始菜单或应用列表里找到 Folia 并打开。
  3. 能看到主界面,就说明 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 等发行版没有官方软件包,官方思路是便携版:整套程序解压在一个目录里,放在哪都由你定。

  1. 从 Releases 页面下载folia-major-0.1.4-linux-x64.tar.gz。
  2. 解压到一个固定目录,这里以 ~/Apps/Folia 为例:
tar -xzf folia-major-0.1.4-linux-x64.tar.gz -C ~/Apps/Folia
  1. 把resources/linux/folia-major.desktop复制到~/.local/share/applications/。
  2. 打开复制出来的 .desktop 文件,将__APP_PATH__换成 folia-major 可执行文件的绝对路径,__ICON_PATH__换成resources/linux/icon.png的绝对路径。
  3. 如果桌面环境要求应用「可信」(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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询