Folia 安装指南在 Windows / macOS / Linux 上跑起全屏歌词播放器【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-majorFolia 是一个全屏沉浸式歌词音乐播放器把歌词做成铺满整个屏幕的动画支持网易云、QQ 音乐、酷狗在线音源也能接入 Navidrome 和本地音乐库。本文覆盖 Windows、macOS、Linux 三个桌面平台的安装过程。桌面版把前后端运行环境都打进了安装包不需要 Node.js 和任何开发工具跟着走一遍就能放起歌来。先对号入座选对环境与安装包系统目标架构安装包类型获取渠道备注Windows64 位.exe 安装包Releases 页或官方网盘镜像夸克、百度双击走安装向导macOSApple siliconarm64.dmgReleases 页或网盘镜像拖入 Applications 后使用macOSIntel.dmg仅 Releases 页网盘镜像不覆盖Linuxx86_64 / ARM.deb / .rpm / .tar.gz仅 Releases 页架构互不通用按发行版选网盘镜像只覆盖 Windows 与 Apple silicon 的正式版Intel Mac 和所有 Linux 包都要从 Releases 页直接下。文件名都带平台和架构标识下载前逐字比对一次。分平台安装步骤Windows 安装从 Releases 页或网盘镜像下载 .exe。下完先核对文件名里的版本号和 Releases 页最新标注一致才算数对不上就等镜像同步或改走 Releases 重下。双击安装包向导走到底即可。开始菜单或桌面出现 Folia 图标点开能看到主界面装到位了。macOS 安装打开 .dmg把 Folia 拖进 Applications 文件夹。注意不要直接在挂载盘窗口里运行。首次启动如果弹出「Folia.app 已损坏」或「无法验证」不是包坏了官方版本目前没有 Apple Developer ID 签名macOS 拦截的是下载隔离属性。在终端执行下面这条命令再从 Applications 重新打开xattr -dr com.apple.quarantine /Applications/Folia.appmacOS 版暂不支持应用内自动更新每次覆盖安装新版本后都要再跑一次这条命令完整说明见 docs/desktop/macos-app-damaged.md。启动台里能看到 Folia 图标且能打开主界面就对了。Linux 安装Debian / Ubuntu / Mint 下 .debFedora / RHEL / openSUSE 下 .rpm其他发行版用 .tar.gz全部从 Releases 页获取。tar.gz 解压到任意目录直接运行里面的folia-major可执行文件。压缩包自带图标和.desktop模板想建桌面启动项的话把模板复制到~/.local/share/applications/再把__APP_PATH__、__ICON_PATH__两个占位符换成实际绝对路径按桌面环境要求标记可信细节见 packaging/linux/README-LINUX.txt。应用菜单里出现 Folia 且能点开主界面安装完成。首次启动后验证这四项✅ 版本「关于」页版本号和安装包文件名里的版本一致✅ 音源成功登录一个在线音源或导入本地文件夹、接入 Navidrome✅ 歌词播一首带歌词的歌全屏歌词动画正常亮起✅ 主题切换两三个歌词主题排版氛围切换无异常替代与进阶路线AUR 一键安装ArchArch / Manjaro 用户不用手动下包yay -S folia-major-binparu 用户把yay换成paru。程序装到/opt/folia-major依赖项和安装逻辑都在 packaging/aur/folia-major-bin/PKGBUILD 里。构建阶段拉压缩包慢的话可以先用网盘下好同版本 tar.gz 放进 AUR 源码目录再执行makepkg -si。Docker 部署 Web 版NAS / 浏览器不装桌面端可以把 Web 版本部署到 NAS 或服务器。完整堆栈的 Compose 文件在 deploy/docker/要求 Docker Engine 24 与 Compose v2启动后默认访问http://NAS-IP:18080。环境变量、Navidrome 预置账号等配置见 deploy/docker/README.md。手机 PWAWeb 版部署好后在 Chrome for Android 或 iOS Safari 里把页面添加到主屏幕手机上就能当 App 用适合移动端场景。问题速查下载总断流→ 多为国内网络直连 GitHub Releases 太慢 → 换官方网盘镜像夸克、百度取回后再核对一遍版本号。Linux 启动黑屏或闪退→ 多半是 GPU 兼容问题 → 用FOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-major以软件渲染验证仍不稳定切software确认是显卡问题后再用system恢复系统路径。macOS 提示应用已损坏→ 未签名应用带下载隔离属性被 Gatekeeper 拦截 → 执行xattr -dr com.apple.quarantine /Applications/Folia.app后重新打开。拿错了包→ Intel Mac 装了 Apple silicon 版或 Linux 架构不匹配 → 回 Releases 页逐字比对文件名再重新下载。挑一首带歌词的歌让整屏亮起来。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考