Folia 安装教程：Windows / macOS / Linux 全平台下载与部署指南

Folia 安装教程Windows / macOS / Linux 全平台下载与部署指南【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-majorFolia 是一个把歌词渲染成全屏动画的桌面播放器支持网易云、酷狗、Navidrome 与本地音乐库。这篇 Folia 下载安装教程带你走完全流程先判断该拿哪个包再按平台装完最后自查与排障顺利的话五分钟装好。先决定拿哪个包选错渠道会白走弯路按「平台/芯片 → 网络环境 → 包管理习惯」三步判断平台/芯片网盘镜像只有 Windows 与 Apple silicon macOS 两个包Intel Mac 的 dmg 和全部 Linux 包都在 Releases 页面。网络环境国内网络且目标平台在网盘里 → 直接走网盘其余情况 → 去 Releases 页面。包管理习惯Arch 系且已装 yay 或 paru → AUR 包folia-major-bin一条命令了事其余 → 手动拿 linux-x64 便携包。对应下来Windows 与 Apple silicon国内网络走网盘夸克或百度链接百度提取码fliaIntel Mac 走 Releases 页面的 dmgArch 系走 AURDebian / Ubuntu / Fedora 等非 Arch 系走 linux-x64 便携包。分平台安装Folia Windows 安装网盘取包一路下一步Windows 的安装路径最短从网盘拿安装器一路下一步。打开项目README.md的「快速下载」一节拿到夸克或百度网盘链接百度提取码flia。对一眼网盘里的包版本与最新 release明显落后就改走 Releases 页面。下载.exe安装器双击后按提示装完。从开始菜单启动 Folia。 注意网盘只有 Windows 与 Apple silicon 两个包。链接失效时以README.md「快速下载」一节的最新链接为准。Folia Mac 下载与安装Apple silicon 与 Intel 两条路两条路的动作相同——挂载 dmg、把Folia.app拖进 Applications区别只在取包位置。Apple silicon从网盘拿 dmgREADME.md「快速下载」一节挂载后把Folia.app拖入 Applications。Intel网盘没有 Intel 包去项目 Releases 页面下载当前版本对应 Intel Mac 的 dmg挂载后同样拖入 Applications。⚠️ 拖完后别直接在挂载盘里运行。若 macOS 首次启动弹出「应用已损坏」或「无法验证」是因为当前 macOS 版没有 Developer ID 签名与公证Gatekeeper 拦截属正常现象。在终端执行xattr -dr com.apple.quarantine /Applications/Folia.app # 移除下载隔离属性再从 Applications 重新打开 常见坑每次手动重装后隔离属性都会回来需要再执行一遍上面的命令。Folia AUR 安装Arch 系一条命令已装 yay 或 paru 的 Arch 用户AUR 是自动化程度最高的一条路。确认 AUR 助手可用yay --version # 确认 AUR 助手已安装paru 用户把命令名换成 paru安装预编译二进制包yay -S folia-major-bin # 构建时从 Releases 拉 linux-x64 包装进 /opt/folia-major验证命令可直接执行包会在/usr/bin建软链接which folia-major # 输出 /usr/bin/folia-major 即安装成功在应用菜单里找到 Folia启动它。 常见坑AUR 包当前版本0.1.4依赖alsa-lib、gtk3、libxss、nss可在packaging/aur/folia-major-bin/PKGBUILD逐项核对构建卡在下载步骤多为网络问题别干等直接转下面的便携包。Folia Linux 部署Debian / Ubuntu / Fedora 便携包手动装非 Arch 系发行版官方只给便携包这一种形态需要自己解压到固定目录。到 Releases 页面下载当前版本的 linux-x64 包文件名形如folia-major-version-linux-x64.tar.gz。解压到一个固定目录mkdir -p ~/Apps/Folia tar -xzf folia-major-*-linux-x64.tar.gz -C ~/Apps/Folia # 整套程序放进固定目录把便携包自带的桌面项模板复制到用户级应用目录cp ~/Apps/Folia/resources/linux/folia-major.desktop ~/.local/share/applications/ # 复制桌面项模板打开复制出的.desktop文件填对两处占位符__APP_PATH__填folia-major可执行文件的绝对路径__ICON_PATH__填resources/linux/icon.png的绝对路径。桌面环境有要求时将该.desktop标记为可信再从应用菜单启动 Folia。 常见坑便携包一共三样东西folia-major可执行文件、resources/linux/icon.png与桌面项模板。排查问题时先确认可执行文件与resources/位于同一便携包目录。装完之后装没装好不挑平台满足下面三条就算完成应用菜单里出现 Folia 条目Windows 看开始菜单、macOS 看 Applications、Linux 看应用菜单点开后能进入首页看到歌单 / 文件夹标签页和搜索框随便播放一首歌能看到全屏歌词动画动起来Linux 黑屏解决切换渲染模式Linux 启动后若黑屏、透明度 / 模糊异常或 GPU 崩溃先别怀疑装坏了通常是图形路径问题用环境变量切换渲染模式即可。FOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-major # 以 swiftshader 软件渲染方式启动swiftshader 下仍不稳定的话把变量值改成software即最保守的软件渲染档位FOLIA_LINUX_GRAPHICS_MODEsoftware ./folia-major # 最保守的软件渲染档位出了问题按「现象 → 处理」列出最常遇到的几类情况网盘里找不到自己平台的包Intel Mac、各类 Linux→ 网盘只有 Windows 与 Apple silicon 两个包去 Releases 页面取对应平台的包。网盘版本落后于最新 release或链接失效→ 以README.md「快速下载」一节的最新镜像链接为准仍不行就改走 Releases。AUR 构建卡在下载步骤→ 放弃 AUR转 linux-x64 便携包手动部署。macOS 提示「应用已损坏」或「无法验证」→ 终端执行xattr -dr com.apple.quarantine /Applications/Folia.app移除隔离属性再从 Applications 重新打开。Linux 启动黑屏、透明度异常或 GPU 崩溃→ 用FOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-major启动仍不稳定再把值改成software。桌面快捷方式不显示→ 检查.desktop文件的Exec/Icon是否填了绝对路径并把该文件标记为可信。延伸阅读docs/technical.md技术与开发说明Linux 图形模式、Wayland / Hyprland 遥控窗等桌面端细节都在这是黑屏问题的进阶去处。packaging/linux/README-LINUX.txt便携包自带说明书讲清包里三样东西和全部图形环境变量。packaging/aur/folia-major-bin/PKGBUILDAUR 包源码依赖、安装路径与软链接逻辑可逐项核对。deploy/docker/README.md不想装桌面端时的备选路线Docker Compose 全栈部署 Web 版本。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考