Folia 全屏歌词播放器安装与下载完整指南Windows、macOS、Linux 三种平台一次装好【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-majorFolia 全屏歌词播放器是一个把歌词渲染成全屏动画的桌面音乐播放器。这篇教程只解决一件事让你把应用装好并看到首页。不展开功能介绍与源码全文三步选路 → 落地 → 验收。准备与选路四种取包通道对比方式适用平台与环境前置/网络条件备注网盘镜像 Windows.exe、Apple silicon Mac.dmg仅此两种国内网络只收录这两种安装包百度云提取码flia版本可能落后于最新 release下载前核对文件名中的版本号Releases 直连Windows、macOS两种芯片、Linux 全部平台能稳定直连仓库安装包最全且始终是最新版AUR 仅限 Arch 系需预装yay或paru直连仓库包名folia-major-bin依赖alsa-lib、gtk3、libxss、nss清单见 packaging/aur/folia-major-bin/PKGBUILDDocker Compose任意可装 Docker 的机器用浏览器访问不限不装桌面端走全栈部署见 deploy/docker/README.mdmacOS 用户先确认芯片再动手Apple silicon 选 arm64 的 dmgIntel 选 x64 的 dmg。当前发布版本为 0.1.4以仓库 Releases 页面实际为准Linux 包对应folia-major-0.1.4-linux-x64.tar.gz。分平台落地从取包到启动Windows 安装包与 macOS dmg 安装Windows 从 Releases 页面下载.exe国内网络可走网盘镜像双击安装一路默认。通过标志开始菜单出现 Folia启动后首页完整渲染。macOS 先确认芯片苹果菜单 → 关于本机再下载对应 arm64 或 x64 的.dmg双击后把图标拖进 Applications。通过标志Launchpad 中能打开 Folia 并看到首页首次启动若被系统拦截到「系统设置 → 隐私与安全性」里允许一次即可。Linux 便携版手动部署四步走便携包不挑发行版也不需要 root 权限tar -xzf folia-major-0.1.4-linux-x64.tar.gz -C ~/Apps/Folia cp ~/Apps/Folia/resources/linux/folia-major.desktop ~/.local/share/applications/固定目录解压先建一个长期有效的目录例如~/Apps/Folia再执行第一条命令。通过标志该目录下出现folia-major可执行文件且与resources/目录同级。复制桌面启动项模板执行第二条命令。通过标志~/.local/share/applications/下多了一份folia-major.desktop。替换两个占位符用文本编辑器打开这份.desktop文件把__APP_PATH__改成folia-major可执行文件的绝对路径__ICON_PATH__改成resources/linux/icon.png的绝对路径。通过标志文件里不再残留__开头的占位文本。从应用菜单启动部分桌面环境要求把该条目标记为可信。通过标志菜单里出现 Folia 图标并能正常启动。跳过条件Arch 系可跳过以上四步直接执行yay -S folia-major-bin它会把同一份 tar.gz 装到/opt/folia-major并建好桌面项。Docker Compose 部署 Web 版跳过条件你只是要在自己电脑的桌面上听歌直接看上面两节本节可整体跳过。安装 Docker Engine 24 与 Docker Compose v2。通过标志docker compose version输出版本号。按 deploy/docker/README.md 的「快速启动」新建空目录folia-docker把compose.yaml与环境变量模板.env放进同一目录。通过标志该目录下只有这两个文件。执行openssl rand -hex 32生成随机串填进.env的SYNC_TOKEN。通过标志.env里SYNC_TOKEN已有非空值。启动并验证docker compose config docker compose pull docker compose up -d --wait docker compose ps通过标志docker compose ps显示全部容器运行正常。浏览器打开http://NAS-IP:18080换成你的机器实际 IP。通过标志看到 Folia Web 首页Sync Server 可另开http://NAS-IP:13000/health自查。验收与排障成功判据与症状对照表以下三条全部满足才算安装成功首页正常渲染无黑屏、布局完整。能搜索到歌曲并起播。播放后歌词在全屏舞台上动起来Web 版即浏览器窗口内。症状可能原因处理操作启动黑屏、透明度或模糊异常显卡驱动与硬件加速路径不兼容用FOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-major切软件渲染复测swiftshader 下画面仍不稳定该机器图形栈对 swiftshader 支持不佳改用FOLIA_LINUX_GRAPHICS_MODEsoftware ./folia-major把它作为这台机器的日常启动方式AUR 构建卡在下载步骤本质仍是回 Releases 取包直连受阻放弃等待回到 Linux 便携版手动部署流程桌面快捷方式不显示占位符未替换成绝对路径或文件未标记可信打开.desktop检查Exec与Icon两行补齐路径后按桌面要求标记可信网盘里找不到对应平台的包网盘只收录 Windows 与 Apple silicon 两种安装包Intel Mac、Linux 及其他平台一律以 Releases 页面为准收尾选对通道取包、按平台落地、对照判据验证三步走完 Folia 就跑起来了。更深的资料在这里Linux 图形模式等桌面端细节见 docs/technical.md便携版目录结构与桌面项模板说明见 packaging/linux/README-LINUX.txtDocker 全栈部署见 deploy/docker/README.mdAUR 包清单见 packaging/aur/folia-major-bin/PKGBUILD 【免费下载链接】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 全屏歌词播放器是一个把歌词渲染成全屏动画的桌面音乐播放器。这篇教程只解决一件事让你把应用装好并看到首页。不展开功能介绍与源码全文三步选路 → 落地 → 验收。准备与选路四种取包通道对比方式适用平台与环境前置/网络条件备注网盘镜像 Windows.exe、Apple silicon Mac.dmg仅此两种国内网络只收录这两种安装包百度云提取码flia版本可能落后于最新 release下载前核对文件名中的版本号Releases 直连Windows、macOS两种芯片、Linux 全部平台能稳定直连仓库安装包最全且始终是最新版AUR 仅限 Arch 系需预装yay或paru直连仓库包名folia-major-bin依赖alsa-lib、gtk3、libxss、nss清单见 packaging/aur/folia-major-bin/PKGBUILDDocker Compose任意可装 Docker 的机器用浏览器访问不限不装桌面端走全栈部署见 deploy/docker/README.mdmacOS 用户先确认芯片再动手Apple silicon 选 arm64 的 dmgIntel 选 x64 的 dmg。当前发布版本为 0.1.4以仓库 Releases 页面实际为准Linux 包对应folia-major-0.1.4-linux-x64.tar.gz。分平台落地从取包到启动Windows 安装包与 macOS dmg 安装Windows 从 Releases 页面下载.exe国内网络可走网盘镜像双击安装一路默认。通过标志开始菜单出现 Folia启动后首页完整渲染。macOS 先确认芯片苹果菜单 → 关于本机再下载对应 arm64 或 x64 的.dmg双击后把图标拖进 Applications。通过标志Launchpad 中能打开 Folia 并看到首页首次启动若被系统拦截到「系统设置 → 隐私与安全性」里允许一次即可。Linux 便携版手动部署四步走便携包不挑发行版也不需要 root 权限tar -xzf folia-major-0.1.4-linux-x64.tar.gz -C ~/Apps/Folia cp ~/Apps/Folia/resources/linux/folia-major.desktop ~/.local/share/applications/固定目录解压先建一个长期有效的目录例如~/Apps/Folia再执行第一条命令。通过标志该目录下出现folia-major可执行文件且与resources/目录同级。复制桌面启动项模板执行第二条命令。通过标志~/.local/share/applications/下多了一份folia-major.desktop。替换两个占位符用文本编辑器打开这份.desktop文件把__APP_PATH__改成folia-major可执行文件的绝对路径__ICON_PATH__改成resources/linux/icon.png的绝对路径。通过标志文件里不再残留__开头的占位文本。从应用菜单启动部分桌面环境要求把该条目标记为可信。通过标志菜单里出现 Folia 图标并能正常启动。跳过条件Arch 系可跳过以上四步直接执行yay -S folia-major-bin它会把同一份 tar.gz 装到/opt/folia-major并建好桌面项。Docker Compose 部署 Web 版跳过条件你只是要在自己电脑的桌面上听歌直接看上面两节本节可整体跳过。安装 Docker Engine 24 与 Docker Compose v2。通过标志docker compose version输出版本号。按 deploy/docker/README.md 的「快速启动」新建空目录folia-docker把compose.yaml与环境变量模板.env放进同一目录。通过标志该目录下只有这两个文件。执行openssl rand -hex 32生成随机串填进.env的SYNC_TOKEN。通过标志.env里SYNC_TOKEN已有非空值。启动并验证docker compose config docker compose pull docker compose up -d --wait docker compose ps通过标志docker compose ps显示全部容器运行正常。浏览器打开http://NAS-IP:18080换成你的机器实际 IP。通过标志看到 Folia Web 首页Sync Server 可另开http://NAS-IP:13000/health自查。验收与排障成功判据与症状对照表以下三条全部满足才算安装成功首页正常渲染无黑屏、布局完整。能搜索到歌曲并起播。播放后歌词在全屏舞台上动起来Web 版即浏览器窗口内。症状可能原因处理操作启动黑屏、透明度或模糊异常显卡驱动与硬件加速路径不兼容用FOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-major切软件渲染复测swiftshader 下画面仍不稳定该机器图形栈对 swiftshader 支持不佳改用FOLIA_LINUX_GRAPHICS_MODEsoftware ./folia-major把它作为这台机器的日常启动方式AUR 构建卡在下载步骤本质仍是回 Releases 取包直连受阻放弃等待回到 Linux 便携版手动部署流程桌面快捷方式不显示占位符未替换成绝对路径或文件未标记可信打开.desktop检查Exec与Icon两行补齐路径后按桌面要求标记可信网盘里找不到对应平台的包网盘只收录 Windows 与 Apple silicon 两种安装包Intel Mac、Linux 及其他平台一律以 Releases 页面为准收尾选对通道取包、按平台落地、对照判据验证三步走完 Folia 就跑起来了。更深的资料在这里Linux 图形模式等桌面端细节见 docs/technical.md便携版目录结构与桌面项模板说明见 packaging/linux/README-LINUX.txtDocker 全栈部署见 deploy/docker/README.mdAUR 包清单见 packaging/aur/folia-major-bin/PKGBUILD 【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
)
