★ FEATURED ARTICLE 如何安装 Folia 全屏歌词播放器30 秒选对包5 分钟零踩坑跑起来【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器 A multi-platform music player for local files, Navidrome, and online streaming services, featuring stunning animated lyrics.项目地址: https://gitcode.com/GitHub_Trending/fo/folia-majorFolia 是一款开源音乐播放器能把 QQ 音乐、网易云、酷狗等在线音源、Navidrome 和本地音频文件夹统一接入让歌词以全屏动态画面的形式跟着旋律动。本文把下载、安装、验证三步拆成可照抄的操作覆盖 Windows、macOS、Linux 三个系统和 Web 自托管路线全程约 5 分钟。先看这张表不同机器该拿哪个安装包全部安装包都发布在项目的 Releases 页面文件名里直接写死了系统与架构半分钟看表就能锁定你要的那一个。x64 与 ARM 架构的包互不通用拿错装不上。运行环境包类型文件名样式Windows 64 位安装向导Folia-Setup-版本号.exeApple 芯片 MacM1/M2/M3…磁盘镜像Folia-版本号-arm64.dmgIntel 芯片 Mac磁盘镜像Folia-版本号-x64.dmgLinux x86_64压缩包另有 .deb / .rpmfolia-major-版本号-linux-x64.tar.gz 国内网络直连 Releases 速度不稳。README.md 的「快速下载」一节提供夸克网盘、百度云盘两个镜像入口但镜像只覆盖 Windows 与 Apple 芯片 Mac 的正式版Linux 包没有镜像、只能走 Releases。镜像偶尔比官方版本落后一拍下载后先对一眼版本号再开始装。三步装完三个系统的完整安装流程每条流程都是「下载 → 安装 → 核对版本号」三个动作装完立即进系统内核对别把问题留到最后。Windows双击 exe跟着向导装到底从 Releases 下载Folia-Setup-版本号.exe与页面标注的最新版本号核对一致。双击运行向导自带中文界面安装位置保持默认即可也可自行指定磁盘。按提示完成安装桌面与开始菜单都会生成 Folia 快捷方式点击即可进入主界面。安装包已把运行环境整个打包进去机器上不需要预装 Node.js 等任何开发工具。macOS拖进 Applications再用一条命令解除隔离打开Folia-版本号-arm64.dmgIntel 机器选 x64 那份把挂载窗口里的 Folia.app 拖入 Applications 目录不要在挂载窗口里直接运行。首次启动大概率被 Gatekeeper 拦截弹出「Folia.app 已损坏无法打开」。在终端执行下面的命令然后从 Applications 重新启动。# 移除应用的下载隔离属性之后从 Applications 重新打开 xattr -dr com.apple.quarantine /Applications/Folia.app⚠️ 报「已损坏」不是包坏了当前 macOS 版本没有 Apple Developer ID 签名与公证浏览器下载会自动带上隔离属性未签名应用就被拦成这个提示。其他拦截文案如仅提示「无法验证」的完整处理见 macOS 拦截处理。⚠️ macOS 版暂不支持应用内自动更新。以后每次覆盖安装新版本上面这条xattr命令都要重跑一遍。Linux解压后直接运行Arch 用户一条命令搞定通用发行版Ubuntu、Debian、Fedora 等下载folia-major-版本号-linux-x64.tar.gz支持 .deb / .rpm 的发行版可直接装对应文件解压到任意目录直接运行里面的folia-major可执行文件。想给应用菜单添一个入口把包内resources/linux/folia-major.desktop复制到~/.local/share/applications/再把文件里的__APP_PATH__、__ICON_PATH__两个占位符替换成可执行文件与图标resources/linux/icon.png的绝对路径桌面环境若有要求把该文件标记为可信。包结构、替换示例与图形兼容细节完整收录在 packaging/linux/README-LINUX.txt。Arch LinuxAUR 预构建包# 安装 AUR 预构建包若你使用 paru把命令里的 yay 换成 paru yay -S folia-major-binalsa-lib、gtk3、libxss、nss等依赖由 AUR 自动解决程序落在/opt/folia-major启动命令就是folia-major。⚠️ PKGBUILD 里固定的版本号可能落后于 Releases 的最新发布装完记得核对清单见 PKGBUILD。图形兼容排障⚠️ 启动后黑屏、透明度异常或闪退多半是显卡兼容问题不是安装损坏。先用软件渲染启动一次验证# 以软件渲染方式启动排除显卡兼容问题 FOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-major仍不稳定就改用FOLIA_LINUX_GRAPHICS_MODEsoftware确认稳定后可用FOLIA_LINUX_GRAPHICS_MODEsystem恢复系统图形路径。装完做两件事2 步验证全屏歌词真的能用第 1 步核对版本号。打开应用内「关于」页把显示的版本号与下载文件名里的版本号逐字比对。一致才算装对对不上说明拿错了包或镜像没同步回 Releases 重新下载别将就旧版。第 2 步放一首有歌词的歌。登录任一在线音源或导入一个本地音频文件夹进曲库随便点一首带歌词的歌全屏歌词动画会自动亮起。顺手进设置换两三个主题试试每个主题的排版氛围差异很大先感受一下再正式使用不装桌面端也可以Web 版部署到浏览器或 NAS需要命令行基础的话还有另一条路线一键部署在 Vercel 或 Cloudflare 上部署 Web 版手机浏览器访问后「添加到主屏幕」即可当 PWA 用。Docker Compose 自托管参考 deploy/docker/ 目录内的说明搭建完整 Web 栈适合 NAS 长期运行。这条路线涉及环境变量配置门槛比装桌面版高想试的从部署文档入手即可。避坑速查表症状处理动作macOS 提示「已损坏无法打开」终端执行xattr -dr com.apple.quarantine /Applications/Folia.appmacOS 覆盖安装新版后被再次拦截每次更新后重跑一遍上面这条xattr命令Linux 黑屏、透明度异常、闪退FOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-major软件渲染验证「关于」页版本号与文件名对不上镜像落后或拿错包回 Releases 重新下载下载特别慢查 README「快速下载」用网盘镜像仅 Windows 与 Apple 芯片 Mac 正式版装完、对完版本号、看到全屏歌词亮起来才算真正收工——挑一首带歌词的歌把它点下去。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器 A multi-platform music player for local files, Navidrome, and online streaming services, featuring stunning animated lyrics.项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
