Folia 全屏歌词动画播放器完整安装指南桌面、NAS 与多设备一次装好【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-majorFolia 是一个开源的全屏歌词动画播放器能把歌词渲染成铺满整个窗口的文字动画同时接入网易云、QQ 音乐、酷狗在线曲库、Navidrome 私有服务器和本地音乐库桌面端还额外支持波点、YouTube Music、Spotify 与汽水音乐。这篇指南从装包讲到出声带你在自己的电脑上亲手验证一遍。先想清楚用哪种装法动手之前先问自己一句歌主要在哪台设备上听只在个人电脑上听 → 装桌面版十分钟以内能搞定。想在 NAS、电视、手机的浏览器里听或多台设备共用 → 在服务器上部署 Web 版需要 Docker。用 Arch / Manjaro → 桌面版还可以直接走 AUR 一条命令省掉手动处理便携包的麻烦。确认三件小事能省掉后面大半折腾CPU 架构Mac 要分清 Apple silicon 的 arm64 包和 Intel 的 x64 包拿错架构根本装不上。网络能直连 GitHub Releases 就直连连不动就换网盘镜像。镜像只覆盖 Windows 与 Apple silicon 两个平台的正式版版本可能比最新 release 旧下完对一眼版本号。百度提取码是flia。磁盘桌面端解压后的目录至少留 1 GB 余量。桌面版在 Windows / macOS / Linux 上怎么装Windows 与 macOS 装官方安装包到项目 Releases 页面取最新的 0.7.x 版本。Windows 下载.exe双击后按向导一路「下一步」即可macOS 按芯片选 arm64 或 x64 的.dmg把 Folia 拖进Applications。macOS 版没有 Apple Developer ID 签名首次打开大概率被 Gatekeeper 拦下提示「已损坏」或「无法验证」。在终端执行下面命令剥掉隔离属性xattr -dr com.apple.quarantine /Applications/Folia.app跑完重新打开应用就能正常启动。注意 macOS 不支持应用内自动更新以后每次覆盖安装新版本都要再执行一次这条命令。Arch / Manjaro 用 AUR 一行装先确认 AUR helper 可用yay --version再执行构建安装你用 paru 的话把它换进去yay -S folia-major-bin这个包是个薄封装从 release 拉linux-x64包解到/opt/folia-major在/usr/bin建好folia-major链接顺带写入菜单项。依赖是alsa-lib、gtk3、libxss、nss构建结束在终端敲folia-major主窗口弹出来就对了。如果长时间卡在下载步骤是国内直连慢别干等改用下面的便携版。Debian / Ubuntu / Fedora 手动部署便携版从 Releases 取linux-x64.tar.gz解压注意folia-major可执行文件和resources/目录必须始终留在同一目录里只拷单个可执行文件会起不来。先直接跑一遍确认能启动./folia-major想让它进应用菜单把包里的桌面项模板复制到~/.local/share/applications/folia-major.desktop再把文件里的__APP_PATH__、__ICON_PATH__两个占位符替换成可执行文件与图标的绝对路径。逐行说明写在 packaging/linux/README-LINUX.txt。NAS 上跑 Web 版要几步前提是有 Docker Engine 24 与 Compose v2部署全程不需要源码。建一个空目录从仓库deploy/docker/里取compose.yaml和.env.example放进去后者改名为.envmkdir folia-docker cd folia-docker生成一段随机串当同步令牌openssl rand -hex 32把输出粘进.env的SYNC_TOKEN至少八位AI 相关配置留空不影响播放然后启动docker compose up -d --wait容器全部 running 后浏览器访问http://NAS-IP:18080出页面、http://NAS-IP:13000/health返回健康检查通过就算部署成功。网易云、酷狗、QQ 音乐的接口全部收在 gateway 后面对外只暴露这两个端口多台设备想免登录进 Navidrome再填上.env里的NAVIDROME_URL、NAVIDROME_USERNAME、NAVIDROME_PASSWORD三项细节都在 deploy/docker/README.md 的环境变量表里。桌面端装完怎么算成功对三件事都过才算装好版本「帮助」菜单里的 Release Notes 弹窗显示的当前版本和你下载的一致。出声主窗口加载出标题右下角出现播放球随便搜一首歌能正常播放。出字找一首带逐字歌词的歌看全屏动画是否正常逐字渲染。日志方面桌面端没有常驻控制台在「设置 → 开发者」面板里读勾上「Save to file」后日志会落盘到应用数据目录的logs/runtime/启动报错时这里是第一现场。常见症状怎么解Linux 黑屏、透明度或模糊异常多为 GPU 渲染路径不稳先切软件渲染再启动FOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-major仍闪的话退到最保守档FOLIA_LINUX_GRAPHICS_MODEsoftware。排查前顺手确认可执行文件和resources/还在同一个便携包目录里。X11 下提示没有可用的 WebGPUElectron 默认关闭了 Vulkan加上FOLIA_LINUX_VULKAN1并带--ozone-platformx11启动即可原生 Wayland 下开了反而让 GPU 进程崩溃该变量会被忽略。网盘里找不到 Intel Mac 或 Linux 的包镜像只覆盖 Windows 与 Apple silicon回 Releases 页面取对应平台文件。想继续深入看这三份仓库文档桌面壁纸模式与遥控窗等进阶行为在 docs/technical.md接本地曲库前读一遍 docs/local-library-management.md多设备同步外观与 AI 主题库则部署 sync-server/。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考