Folia 快速安装：3 个平台，10 分钟装好并启动
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
Folia 是把歌词渲染成全屏动画的音乐播放器，装完打开，第一首歌词就铺满整块屏幕。本文只做一件事：带你完成 Folia 安装与首次启动，全程不用装任何依赖。桌面版把前后端运行环境打包在内部，不需要 Node.js，也不需要命令行，下载安装包、双击、打开就是全部动作。
动手前，先看清两件事
- 下载渠道：首选项目 Releases 页面，三个平台的包都在那里；国内网络慢就换 README「快速下载」一节的夸克或百度云镜像（百度提取码
flia），镜像只覆盖 Windows 与 Apple silicon 两个正式版。 - 版本核对：装前把包上版本号与仓库根目录
realeco-release记录的当前正式版（目前0.7.23）比对一下，差得远就是镜像版本滞后，回 Releases 取新包。
最快路线：官方安装包
Windows 拿.exe，双击按向导走完。macOS 拿.dmg，打开后把Folia.app拖进Applications；Apple silicon 的 Mac 选带arm64后缀的包，Intel Mac 是另一个包，别混——网盘镜像没有 Intel 版，只能从 Releases 取。打开后：搜首歌、按播放，歌词就在整块屏幕上铺开 🎵
macOS 首次打开可能弹出「
Folia.app已损坏，无法打开」。这不是包坏了，是当前版本没有接入 Apple Developer ID 签名。在终端执行一行命令移除下载隔离属性：xattr -dr com.apple.quarantine /Applications/Folia.app，再从 Applications 重新打开。
Linux 的三条分岔路
Linux 没有统一安装包，按发行版走：
- Arch / Manjaro：装好
yay后执行yay -S folia-major-bin。这个 AUR 包本质是薄封装——构建时从 Releases 拉folia-major-<版本>-linux-x64.tar.gz放进/opt/folia-major，再建一条/usr/bin/folia-major链接。包号目前0.1.4，落后于最新 realeco 正式版，要新版走下面的便携路线。 - Debian / Ubuntu 系取
.deb，Fedora / RHEL / openSUSE 系取.rpm，用系统包管理器直接装。 - 其余发行版用
linux-x64的tar.gz免安装包：解压后三样——folia-major可执行文件、resources/linux/icon.png图标、folia-major.desktop桌面模板，双击可执行文件就能跑。想进应用菜单，把模板复制到~/.local/share/applications/，再替换其中__APP_PATH__、__ICON_PATH__两个占位符为实际绝对路径。
打不开？对这三个信号下手
FOLIA_LINUX_GRAPHICS_MODE只改变 Electron 在 Linux 上的启动参数，不碰 Web 端与同步服务。
- macOS 提示「已损坏」或「无法验证」：执行前文那条
xattr命令后重开。 - AUR 构建卡在下载步骤：与国内下载慢同源，放弃构建，转便携
tar.gz手动部署。 - Linux 启动黑屏、透明度或模糊异常：先试
FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major，仍闪烁就退到FOLIA_LINUX_GRAPHICS_MODE=software ./folia-major。X11 用户提示没有 WebGPU 时还有FOLIA_LINUX_VULKAN=1 ./folia-major --ozone-platform=x11这条后路，原生 Wayland 下该变量被忽略。
装完之后的下一步
- docs/technical.md：发布与更新通道、Linux 打包细节、Wayland / Hyprland 遥控窗规则。
- deploy/docker/README.md：Web 版本的 Docker Compose 全栈部署。
- docs/local-library-management.md：本地音乐库导入、重扫与在线匹配。
装完、点开，等第一首歌词铺上整块屏幕，剩下的交给歌单。
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
