Folia 全屏歌词动画播放器：Windows / macOS / 全 Linux 发行版 5 分钟装好

Folia 全屏歌词动画播放器：Windows / macOS / 全 Linux 发行版 5 分钟装好

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

Folia 是以全屏歌词动画为核心的桌面音乐播放器，支持本地库、Navidrome、网易云、QQ 音乐等音源。国内网络从官方 Releases 下载常限速或中断。本文 5 条路线覆盖 Windows / macOS / Linux，全程 5 分钟装完。

按系统选型：一眼看出你该下哪个包

取舍原则一句话：网盘只有 Windows 与 Apple silicon 的正式版，且可能滞后一个版本；.deb、.rpm、tar.gz只能从 Releases 页面直取。表中<版本>是占位符，一律以 Releases 页面实际展示的版本号替换，别照抄旧包。

Windows：网盘镜像下载，双击 exe 装完

1. 先确认一件事：网盘只有 Windows 与 Apple silicon 的正式版，Linux 包不用在网盘里找。打开 README.md「快速下载」一节，进入夸克网盘或百度网盘（提取码flia）。
2. 这一步的目的：分享链接容易失效限速，先把包转存到自己的网盘再下载。
3. 下载Folia-Setup-<版本>.exe，双击运行，按向导一路下一步装完。

验收锚点：开始菜单和桌面出现 Folia 快捷方式，点一下能正常启动。

翻车点：网盘镜像可能滞后一个版本。选包前对照 Releases 页面版本号，对不上就回 Releases 直取同平台包。

macOS M 芯片 / Intel：拖进 Applications，被拦截就移除隔离

1. 先确认一件事：M 芯片（Apple silicon）选arm64，Intel 选x64。下载Folia-<版本>-arm64.dmg或Folia-<版本>-x64.dmg。
2. 打开 dmg，把Folia.app拖进Applications，不要在挂载盘里直接运行。
3. 若弹出「已损坏 / 无法验证」，在终端移除隔离属性：

xattr -dr com.apple.quarantine /Applications/Folia.app

4. 从Applications重新打开。

验收锚点：启动台 / 应用程序里能看到 Folia，打开不报错；之前弹「已损坏」的，走完第 3 步后不再弹。

翻车点：在挂载盘里直接运行，弹出后应用会崩——不用重装，拖进Applications再打开即可。完整排查见 docs/desktop/macos-app-damaged.md。

Arch / Manjaro：AUR 一条命令构建安装

1. 先确认一件事：AUR helper 可用，预期看到版本号：

yay --version

2. 执行一条命令安装，它会从 Releases 拉取folia-major-<版本>-linux-x64.tar.gz，解包进/opt/folia-major，生成/usr/bin/folia-major命令和菜单项：

yay -S folia-major-bin

3. 依赖规则（alsa-lib、gtk3、libxss、nss）以 packaging/aur/folia-major-bin/PKGBUILD 为准。

验收锚点：应用菜单多出 folia-major 启动项，终端预期输出/usr/bin/folia-major：

which folia-major

翻车点：构建卡在慢速拉包。不用重装，手动下好同版本tar.gz放进构建源码目录，再执行makepkg -si跳过下载。

Debian / Ubuntu / Mint：dpkg 一条命令 + apt 依赖兜底

1. 从 Releases 页面下载folia-major-<版本>-linux-x64.deb。
2. 这一步的目的：把包装好并注册桌面项：

sudo dpkg -i folia-major-*.deb

3. 若提示依赖缺失，执行修复命令一次性补齐：

sudo apt -f install

验收锚点：状态输出install ok installed，应用菜单出现启动项：

dpkg -s folia-major | grep Status

翻车点：dpkg报依赖错时别去逐个找包，apt -f install会全部兜住。

Fedora / RHEL / openSUSE：dnf 装 .rpm，依赖自动处理

1. 从 Releases 页面下载folia-major-<版本>-linux-x64.rpm。
2. 执行安装，dnf自动解析依赖：

sudo dnf install ./folia-major-*.rpm

验收锚点：能打印版本号，应用菜单出现启动项：

rpm -q folia-major

翻车点：老系统（如 RHEL 7）没有dnf，把命令换成yum install即可，包名不变。

其他 Linux 发行版：tar.gz 便携版，解压直接运行

1. 从 Releases 下载folia-major-<版本>-linux-x64.tar.gz，解压到任意目录，如~/Apps/Folia/。
2. 进入该目录直接运行，预期弹出主窗口：

~/Apps/Folia/folia-major

3. 想加桌面启动项：把包内resources/linux/folia-major.desktop复制到~/.local/share/applications/，将__APP_PATH__、__ICON_PATH__两个占位符替换为实际绝对路径。模板见 packaging/linux/folia-major.desktop，完整说明见 packaging/linux/README-LINUX.txt。

验收锚点：终端不报错、主窗口弹出，便携包即可用。

翻车点：可执行文件与resources/必须留在同一便携目录，拆开放会找不到资源直接起不来。

装完验证：三步肉眼检查 + 一条命令

主窗口正常打开、不是黑屏；任选一个源连上（导入本地文件夹或登录在线源），点开任意一首歌；点播放，全屏歌词动画随节奏渲染出来——走到这一步，安装就算真正完成。

AUR 路线补一条命令行终验，预期输出/usr/bin/folia-major：

which folia-major

故障速查：装不上或打不开怎么办

Linux 启动黑屏、透明度异常或闪退→ GPU 渲染兼容问题，切软件渲染启动：

FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major

仍不稳定就用FOLIA_LINUX_GRAPHICS_MODE=software，细节见 packaging/linux/README-LINUX.txt。

macOS 提示「Folia.app 已损坏 / 无法验证」→ 没做 Apple 签名，不是包坏了，移除隔离属性：

xattr -dr com.apple.quarantine /Applications/Folia.app

方案与边界情况见 docs/desktop/macos-app-damaged.md。

AUR 构建卡在 Releases 下载→ 手动下好同版本tar.gz放进构建源码目录，再执行makepkg -si。

网盘里的包和最新版对不上→ 网盘可能滞后，以 Releases 页面版本号为准；更新通道（Realeco / Limo / Cielo）规则见 docs/technical.md。

便携版解压后起不来→ 大概率是目录被拆散，重新整包解压，保持可执行文件与resources/同目录。

选对路线，5 分钟歌词动画跑起来 🎵

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