Folia 歌词动画播放器安装指南Windows、macOS、Linux 三平台从取包到启动【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-majorFolia 是一个把歌词渲染成全屏动画的播放器支持网易云音乐、酷狗、Navidrome 以及本地音乐库。装完在 Windows、macOS 或 Linux 的应用菜单里点一下 Folia就能进入在线音源或本地音乐库的首页。装前准备取包入口桌面安装包都在仓库官方 Releases 页面国内网络慢的话看 README.md「快速下载」一节的夸克网盘 / 百度网盘镜像注意网盘只有 Windows 和 Apple silicon 两种包。下载前核对三样东西平台Windows / macOS / Linux、架构x64 与 arm64、Intel 与 Apple silicon、版本号。当前桌面版版本号为0.7.23文件名里的数字要对上网盘版本如果比这旧直接回官方 Releases 取。前置依赖桌面版内置运行环境不用预装 Node.js 或编译工具Arch 用户需要 yay 或 paru 这类 AUR 助手Linux 需要有正常桌面环境。各平台包名对照平台取包来源包名Windows x64官方 Releases / 网盘镜像Folia-Setup-0.7.23.exemacOSApple silicon官方 Releases / 网盘镜像Folia-0.7.23-arm64.dmgmacOSIntel官方 ReleasesFolia-0.7.23-x64.dmgDebian / Ubuntu官方 Releasesfolia-major-0.7.23-linux-amd64.debFedora / openSUSE官方 Releasesfolia-major-0.7.23-linux-x86_64.rpm其他 Linux 发行版官方 Releasesfolia-major-0.7.23-linux-x64.tar.gzArch / ManjaroAUR 包folia-major-bin—分平台安装Windows 安装包从哪取、怎么装到官方 Releases 页面下载Folia-Setup-0.7.23.exe。双击运行按向导点完即可不需要额外装依赖。开始菜单里出现 Folia、点开是首页这步就成了。macOS 按芯片取 dmgApple siliconM 系列下载Folia-0.7.23-arm64.dmgIntel Mac 下载Folia-0.7.23-x64.dmg。网盘镜像只有前者Intel Mac 直接走官方 Releases别在网盘上耗时间。双击 dmg 挂载后把Folia.app拖进Applications不要直接在挂载盘里运行。弹应用已损坏时先执行xattr -dr com.apple.quarantine /Applications/Folia.app应用菜单里出现 Folia、打开进入首页这步就成了。Linux 按发行版取包Arch / Manjaro确认 AUR 助手可用yay --version。执行安装yay -S folia-major-bin用 paru 的用户改成paru -S folia-major-bin。这个 AUR 包本质是去官方 Releases 拉 linux-x64 包装到/opt/folia-major运行时依赖 alsa-lib、gtk3、libxss、nss构建卡在下载环节就别干等直接改用下面的便携部署。Debian / Ubuntu / Fedora / openSUSE下载对应发行版的包后安装sudo dpkg -i folia-major-0.7.23-linux-amd64.debsudo rpm -i folia-major-0.7.23-linux-x86_64.rpm其他发行版便携版手动部署下载folia-major-0.7.23-linux-x64.tar.gz解压到固定目录tar -xzf folia-major-0.7.23-linux-x64.tar.gz -C ~/Apps/Folia复制桌面启动项模板cp ~/Apps/Folia/resources/linux/folia-major.desktop ~/.local/share/applications/编辑复制后的文件把__APP_PATH__替换成~/Apps/Folia/folia-major的绝对路径__ICON_PATH__替换成~/Apps/Folia/resources/linux/icon.png的绝对路径。桌面环境要求的话把这个 .desktop 文件标记为可信。终端能执行folia-major命令、应用菜单里出现 Folia这步就成了。装完怎么验打开看一眼首页应该落在在线音源网易云 / 酷狗 / Navidrome的登录或搜索页或本地音乐库导入页没有白屏、黑屏。放一首带歌词的歌播放时全屏歌词动画正常出现、封面和歌词都加载出来说明渲染链路没装歪。本地库用户导入目录后歌曲列表能出封面说明本地索引工作正常。高频踩坑速查现象Linux 启动后黑屏或透明度、模糊异常甚至 GPU 崩溃。原因GPU 驱动与 Electron 图形栈不兼容不是装错了。解法先切软件渲染再下结论FOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-major仍不稳定的机器再退一档FOLIA_LINUX_GRAPHICS_MODEsoftware ./folia-major现象macOS 提示Folia.app 已损坏无法打开。原因当前 macOS 包没有 Apple Developer ID 签名与公证Gatekeeper 拦截。解法xattr -dr com.apple.quarantine /Applications/Folia.app现象Linux 便携版解压后应用菜单里没有 Folia或快捷方式点了没反应。原因.desktop 里的__APP_PATH__/__ICON_PATH__没替换成绝对路径或文件没标记可信。解法检查 .desktop 中 Exec 与 Icon 都是绝对路径把文件标记可信后从应用菜单启动。现象网盘镜像里找不到要的平台包或版本号偏旧。原因网盘只放了 Windows 与 Apple silicon 两种包且版本可能落后官方 Releases。解法回官方 Releases 页面取包网盘链接的时效以 README.md「快速下载」一节为准。延伸阅读docs/technical.mdLinux 图形模式、Wayland / Hyprland 遥控窗等桌面端细节docs/desktop/macos-app-damaged.mdmacOS 提示应用已损坏 / 无法验证的原因与修法packaging/linux/README-LINUX.txt便携版目录结构、图形变量与壁纸模式说明deploy/docker/README.mdDocker Compose 全栈部署 Web 版本不想装桌面端时的另一条路 【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Folia 歌词动画播放器安装指南Windows、macOS、Linux 三平台从取包到启动【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-majorFolia 是一个把歌词渲染成全屏动画的播放器支持网易云音乐、酷狗、Navidrome 以及本地音乐库。装完在 Windows、macOS 或 Linux 的应用菜单里点一下 Folia就能进入在线音源或本地音乐库的首页。装前准备取包入口桌面安装包都在仓库官方 Releases 页面国内网络慢的话看 README.md「快速下载」一节的夸克网盘 / 百度网盘镜像注意网盘只有 Windows 和 Apple silicon 两种包。下载前核对三样东西平台Windows / macOS / Linux、架构x64 与 arm64、Intel 与 Apple silicon、版本号。当前桌面版版本号为0.7.23文件名里的数字要对上网盘版本如果比这旧直接回官方 Releases 取。前置依赖桌面版内置运行环境不用预装 Node.js 或编译工具Arch 用户需要 yay 或 paru 这类 AUR 助手Linux 需要有正常桌面环境。各平台包名对照平台取包来源包名Windows x64官方 Releases / 网盘镜像Folia-Setup-0.7.23.exemacOSApple silicon官方 Releases / 网盘镜像Folia-0.7.23-arm64.dmgmacOSIntel官方 ReleasesFolia-0.7.23-x64.dmgDebian / Ubuntu官方 Releasesfolia-major-0.7.23-linux-amd64.debFedora / openSUSE官方 Releasesfolia-major-0.7.23-linux-x86_64.rpm其他 Linux 发行版官方 Releasesfolia-major-0.7.23-linux-x64.tar.gzArch / ManjaroAUR 包folia-major-bin—分平台安装Windows 安装包从哪取、怎么装到官方 Releases 页面下载Folia-Setup-0.7.23.exe。双击运行按向导点完即可不需要额外装依赖。开始菜单里出现 Folia、点开是首页这步就成了。macOS 按芯片取 dmgApple siliconM 系列下载Folia-0.7.23-arm64.dmgIntel Mac 下载Folia-0.7.23-x64.dmg。网盘镜像只有前者Intel Mac 直接走官方 Releases别在网盘上耗时间。双击 dmg 挂载后把Folia.app拖进Applications不要直接在挂载盘里运行。弹应用已损坏时先执行xattr -dr com.apple.quarantine /Applications/Folia.app应用菜单里出现 Folia、打开进入首页这步就成了。Linux 按发行版取包Arch / Manjaro确认 AUR 助手可用yay --version。执行安装yay -S folia-major-bin用 paru 的用户改成paru -S folia-major-bin。这个 AUR 包本质是去官方 Releases 拉 linux-x64 包装到/opt/folia-major运行时依赖 alsa-lib、gtk3、libxss、nss构建卡在下载环节就别干等直接改用下面的便携部署。Debian / Ubuntu / Fedora / openSUSE下载对应发行版的包后安装sudo dpkg -i folia-major-0.7.23-linux-amd64.debsudo rpm -i folia-major-0.7.23-linux-x86_64.rpm其他发行版便携版手动部署下载folia-major-0.7.23-linux-x64.tar.gz解压到固定目录tar -xzf folia-major-0.7.23-linux-x64.tar.gz -C ~/Apps/Folia复制桌面启动项模板cp ~/Apps/Folia/resources/linux/folia-major.desktop ~/.local/share/applications/编辑复制后的文件把__APP_PATH__替换成~/Apps/Folia/folia-major的绝对路径__ICON_PATH__替换成~/Apps/Folia/resources/linux/icon.png的绝对路径。桌面环境要求的话把这个 .desktop 文件标记为可信。终端能执行folia-major命令、应用菜单里出现 Folia这步就成了。装完怎么验打开看一眼首页应该落在在线音源网易云 / 酷狗 / Navidrome的登录或搜索页或本地音乐库导入页没有白屏、黑屏。放一首带歌词的歌播放时全屏歌词动画正常出现、封面和歌词都加载出来说明渲染链路没装歪。本地库用户导入目录后歌曲列表能出封面说明本地索引工作正常。高频踩坑速查现象Linux 启动后黑屏或透明度、模糊异常甚至 GPU 崩溃。原因GPU 驱动与 Electron 图形栈不兼容不是装错了。解法先切软件渲染再下结论FOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-major仍不稳定的机器再退一档FOLIA_LINUX_GRAPHICS_MODEsoftware ./folia-major现象macOS 提示Folia.app 已损坏无法打开。原因当前 macOS 包没有 Apple Developer ID 签名与公证Gatekeeper 拦截。解法xattr -dr com.apple.quarantine /Applications/Folia.app现象Linux 便携版解压后应用菜单里没有 Folia或快捷方式点了没反应。原因.desktop 里的__APP_PATH__/__ICON_PATH__没替换成绝对路径或文件没标记可信。解法检查 .desktop 中 Exec 与 Icon 都是绝对路径把文件标记可信后从应用菜单启动。现象网盘镜像里找不到要的平台包或版本号偏旧。原因网盘只放了 Windows 与 Apple silicon 两种包且版本可能落后官方 Releases。解法回官方 Releases 页面取包网盘链接的时效以 README.md「快速下载」一节为准。延伸阅读docs/technical.mdLinux 图形模式、Wayland / Hyprland 遥控窗等桌面端细节docs/desktop/macos-app-damaged.mdmacOS 提示应用已损坏 / 无法验证的原因与修法packaging/linux/README-LINUX.txt便携版目录结构、图形变量与壁纸模式说明deploy/docker/README.mdDocker Compose 全栈部署 Web 版本不想装桌面端时的另一条路 【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
