Folia 安装教程：从装包到第一屏全屏歌词动画-港品优选

Folia 安装教程：从装包到第一屏全屏歌词动画

【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major

Folia 是一个全屏歌词动画音乐播放器，支持本地音乐库与网易云、QQ、酷狗在线音源。这篇覆盖 Folia 安装到首次跑通的完整流程：装包、落地、启动、接入音源，照着做约 10 分钟。

先认门牌

包从官方 Releases 页取，下载后用文件名里的版本号与仓库 realeco-release 文件标注的0.7.23核对；有出入就以 Releases 页为准。国内网络走夸克 / 百度云网盘更快，但网盘只有 Windows 与 Apple silicon 的正式版，提取码flia。

平台	安装包	下载来源	适用条件
Windows	Windows 安装包（以 Releases 页为准）	官方 Releases 页	全版本
macOS	`Folia-<版本>-arm64.dmg`	Releases 页 / 网盘	仅 Apple silicon
Linux	`folia-major-<版本>-linux-x64.tar.gz`	官方 Releases 页	x64 桌面

💡 网盘是滞后镜像，装前看一眼文件名版本号，避免装到旧包。

安装主线

第一步，下载。按上表取对应平台的安装包。此时应看到磁盘里有一个下载文件，文件名版本号与 Releases 页一致。

第二步，落地。Windows：双击安装包，按向导装完。macOS：双击 dmg 挂载后，把Folia.app拖进Applications，别在挂载盘里直接运行，那是临时副本。Linux：解压 tar.gz，直接运行解压目录里的folia-major可执行文件即可；想要桌面启动项，按 packaging/linux/README-LINUX.txt 把.desktop模板里的路径占位符替换成实际路径。此时应看到开始菜单、启动台或应用列表里出现 Folia 入口。若 macOS 弹出"已损坏 / 无法验证"，照下方「常见卡点」处理。

第三步，打开。从启动器打开 Folia。此时应看到主窗口正常落地，首页歌曲卡片整齐排开，没有黑屏或空白。

第一次跑通

本地与在线二选一。

走本地库：打开本地音乐库页面，点"Import Folder"，选一个装了音频的文件夹建索引。

走在线：登录网易云 / QQ / 酷狗，在搜索框搜一首歌播放。

此时应看到：歌曲出声，封面与歌词自动加载，主窗口里歌词动画全屏铺开，逐句高亮、随节奏运动。这是 Folia 的核心画面，看到它即算装成。

常见卡点

症状	多半原因	一条命令或动作
Linux 启动黑屏、透明度异常或闪退	系统图形路径与 GPU 冲突	`FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major`
swiftshader 仍不稳	当前环境不适合硬件加速	`FOLIA_LINUX_GRAPHICS_MODE=software ./folia-major`
macOS 提示"Folia.app 已损坏 / 无法验证"	该版本未做 Apple 公证，下载隔离属性触发拦截	`xattr -dr com.apple.quarantine /Applications/Folia.app`后重开
AUR 构建卡在拉取 Release	GitHub 网络慢	手动把`folia-major-<版本>-linux-x64.tar.gz`放进构建目录，再`makepkg -si`
重启后本地库提示恢复访问权限	系统收回了文件夹读取权限	按界面提示重新授权音乐文件夹

其他装法与代价

Arch / Manjaro：一条yay -S folia-major-bin，装进/opt/folia-major并自动生成启动项；代价是构建时要拉一次 Release 包，网络慢会卡住。
Web / PWA：部署 Web 版（一键部署或 Docker Compose 自托管），再在浏览器里把网页加到主屏幕；代价是服务得自己托管，移动端只能走这条路。
Flatpak：社区第三方包，一键安装；代价是社区维护，版本与内容可能滞后官方桌面版。

走到这里，从装包到第一屏歌词动画的十几分钟就跑完了，Folia 安装完成，后面换主题、加歌单都在同一个窗口里操作。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析