Folia 全屏歌词动画播放器安装与部署指南【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-majorFolia 是一款全屏歌词动画播放器把歌词渲染成覆盖整个屏幕的文字动画音源覆盖网易云、QQ 音乐、酷狗、Navidrome 与本地音乐库。读完本文可完成桌面版安装Windows / macOS / Linux或 Docker 自托管部署并验证全屏歌词动画正常渲染。选路若以电脑桌面听歌、追求沉浸式全屏歌词动画为主走桌面版安装。若要在 NAS 或服务器上自托管 Web 版、供手机浏览器访问走 Docker 自托管部署。若已有 Navidrome 服务器两种形态均可挂接为音源不构成路线独占。若无法判断默认选择桌面版安装动作最少Web 版后续可再补。桌面版安装Windows / macOS打开仓库根目录 README.md 的「快速下载」一节取对应系统的安装包Windows 为.exe安装包macOS 为.dmg镜像。该节同时提供网盘与 Releases 两条下载途径。运行安装程序或挂载镜像完成安装。注意两点网盘镜像仅覆盖 Windows 与 Apple silicon 两个正式版安装包Intel Mac 需改用 Releases 中的 Linux 便携包路线下载前核对版本号网盘镜像可能落后于最新发布。首次启动后在首页搜索平台名称完成账号登录或直接打开本地音乐库导入音频目录。随后播放任意歌曲全屏歌词动画渲染出来即表示安装完成。Linux 安装ArchAUR 助手已安装yay或paru时执行yay -S folia-major-bin助手会自动处理依赖alsa-lib、gtk3、libxss、nss应用部署到/opt/folia-major并生成桌面项。若构建卡在从 Releases 拉取folia-major-版本-linux-x64.tar.gz这一步则改走下方便携包路线自行控制下载进度。通用发行版便携包从 Releases 取linux-x64.tar.gz解压到固定目录如~/Apps/Folia/避免临时目录。将包内resources/linux/folia-major.desktop复制到~/.local/share/applications/。编辑复制出的文件把__APP_PATH__与__ICON_PATH__两处占位符替换为实际绝对路径步骤示例见 packaging/linux/README-LINUX.txt。应用菜单中出现folia-major并成功启动、首页可正常浏览即安装成功。自托管部署Docker部署不需要源码只需两个文件要求 Docker Engine 24 与 Compose v2新建空目录从 deploy/docker/ 取compose.yaml与.env.example两个文件放入后者重命名为.env。执行openssl rand -hex 32生成随机串填入.env的SYNC_TOKEN至少 8 位同步服务必填。执行docker compose up -d启动。浏览器访问http://服务器地址:18080打开 Web 版Sync Server 健康检查在 13000 端口。在线音源 API 与 Folia Web API 同网关运行无需为每个平台单独起服务Navidrome 预置账号等其余环境变量见 deploy/docker/README.md。验收清单在线音源网易云 / QQ 音乐 / 酷狗登录成功或本地目录已导入。播放任意歌曲全屏歌词动画正常渲染。同目录同名.lrc/.vtt等歌词文件被自动识别。本地歌曲的封面与歌词被在线补全。常见问题Linux 启动后黑屏或透明度异常多为 GPU 路径问题。先以软件光栅化模式启动FOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-major仍不稳定则用FOLIA_LINUX_GRAPHICS_MODEsoftware走最保守的软件渲染。同时确认可执行文件与resources/目录仍在同一便携包内——目录被拆开会导致各种异常。这些变量只影响 Linux 桌面端启动参数不改变 Web 版或同步服务配置。下载缓慢、构建卡顿或版本对不上Releases 下载慢时改用便携包路线手动部署自行控制下载进度。注意网盘镜像不包含 Intel Mac 与 Linux 包这两类用户只能走 Releases下载前与 README 核对版本号确保拿到最新安装包。更深的部署细节与环境变量、Linux 渲染机制与 Wayland 壁纸模式见 docs/technical.md本文范围到此为止。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考