Folia 歌词动画播放器 10 分钟安装教程Windows、macOS、Linux 全平台装好并跑通【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-majorFolia 是一款全屏沉浸式歌词动画播放器支持网易云、酷狗、QQ 音乐、Navidrome 和本地音乐库提供 Windows、macOS、Linux 桌面版。这篇 Folia 安装教程覆盖三大平台国内网络从 GitHub Releases 下载慢、各系统装法不同——照着做十几分钟装好并确认能放歌。十秒选路你的系统装哪个Windows / macOS装官方安装包.exe或.dmg全程鼠标点击。Arch / Manjaro一条命令走 AUR。Debian / Ubuntu / Linux Mint.deb原生包。Fedora / RHEL / openSUSE.rpm原生包。其他 Linuxtar.gz便携版解压即用。下载前选包与核对版本号去官方 Releases 页取全平台安装包。国内网络直连慢可走网盘镜像但网盘只提供 Windows 和 Apple silicon 的正式版.deb、.rpm、tar.gz得回 Releases 页拿。包名有规律以0.7.23为例WindowsFolia-Setup-0.7.23.exemacOS Apple 芯片Folia-0.7.23-arm64.dmgmacOS IntelFolia-0.7.23-x64.dmgLinuxfolia-major-0.7.23-linux-x64.deb/.rpm/.tar.gz下载完先看一眼文件名里的版本号。Releases 分 Realeco 正式版latest、Limo 夜更、Cielo 金丝雀三个通道新手认准latest标签即可细节见 docs/technical.md。先别急网盘镜像可能比 Releases 慢一个版本装之前对一下两边版本号别拿旧包。Windows 安装 Folia 桌面版打开安装包对应的下载入口选Folia-Setup-版本.exe双击后按向导一路下一步。装完检查两处开始菜单、桌面有没有 Folia 图标。点一下图标启动主窗口打开、界面正常显示不是黑屏——硬标准主窗口能完整显示首页界面而不是停在黑屏。macOS 安装 Folia 并处理「已损坏」提示先确认芯片Apple 芯片选Folia-版本-arm64.dmgIntel 选-x64.dmg。打开 dmg把Folia.app拖进「应用程序」别在挂载盘里直接运行。首次打开若被系统拦截提示「已损坏 / 无法验证」这不是包坏了是当前版本没有 Apple 开发者签名触发 Gatekeeper。打开「终端」执行下面这条命令移除下载隔离属性xattr -dr com.apple.quarantine /Applications/Folia.app执行完回到「应用程序」重新启动。硬标准终端能列出Folia.app目录内容启动应用不弹任何报错。先别急macOS 版没有应用内自动更新每次覆盖安装新版本后隔离属性会回来这条命令要再执行一次。完整排查见 docs/desktop/macos-app-damaged.md。Arch / Manjaro 用 AUR 安装 Folia确认 AUR helper 可用终端敲yay --version能打印版本号就行用paru的换成paru --version。然后一条命令装好yay -S folia-major-binAUR 构建会从 Releases 拉取同版本tar.gz程序解包进/opt/folia-major生成/usr/bin/folia-major命令和桌面菜单项。依赖alsa-lib、gtk3、libxss、nss构建前可对照 PKGBUILD 核对版本。硬标准which folia-major输出/usr/bin/folia-major应用菜单里多出 folia-major 启动项。在 Debian / Ubuntu 上安装 .deb 包从 Releases 下载folia-major-版本-linux-x64.deb用下面命令安装sudo dpkg -i folia-major-*.deb若提示依赖缺失别删包重装接着执行这句补齐依赖sudo apt -f install硬标准dpkg -s folia-major输出状态为install ok installed应用菜单出现 Folia。在 Fedora / openSUSE 上安装 .rpm 包下载folia-major-版本-linux-x64.rpm后用 dnf 安装./前缀不能省sudo dnf install ./folia-major-*.rpm少了./dnf 会去在线仓库找包然后报「找不到」。硬标准rpm -q folia-major打印出folia-major-版本。其他 Linux 发行版用 tar.gz 便携版下载folia-major-版本-linux-x64.tar.gz解压到固定目录例如~/Apps/Folia/进入该目录直接运行./folia-major主窗口弹出来硬标准终端无报错且 Folia 主窗口正常显示。启动黑屏、透明度异常或闪退多半是 GPU 渲染路径不兼容切软件渲染再试FOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-major仍不稳定就用最保守的FOLIA_LINUX_GRAPHICS_MODEsoftware ./folia-major。想加常驻启动项把包内resources/linux/folia-major.desktop复制到~/.local/share/applications/替换其中__APP_PATH__、__ICON_PATH__两个占位符为实际绝对路径模板说明见 packaging/linux/README-LINUX.txt。装完 Folia 后的三步跑通流程装上了不等于跑通了按顺序走三步全过才算真正能用打开主窗口——界面正常显示不是黑屏。连上一个音源——导入本地音乐文件夹或登录任一在线源点开任意一首歌。点播放——全屏歌词动画随节奏渲染出来走到这里就算跑通了。全屏歌词不止一种排版内置多个主题可切换风格参考 img/preview-tilt.png 这类预览。装完 Folia 遇到报错怎么办问Linux 启动黑屏、透明度异常或闪退切软件渲染FOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-major仍不稳再改software。问macOS 说「已损坏」未签名触发 Gatekeeper 拦截执行xattr -dr com.apple.quarantine /Applications/Folia.app移除隔离属性。问AUR 构建卡在 Releases 下载手动下好同版本tar.gz放进构建源码目录再执行makepkg -si跳过下载继续构建。问.deb装完提示依赖缺失sudo apt -f install一次补齐这是正常现象。问网盘里的包和最新版本对不上镜像滞后了以 Releases 页latest的版本号为准重新选包。Linux 桌面端细节Wayland、遥控窗等可继续看 docs/technical.md。装好跑通之后全屏歌词动画就属于你了 【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
