Folia 歌词动画音乐播放器完整安装教程Windows、macOS、Linux 全流程【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-majorFolia 是一款把歌词渲染成全屏动画的音乐播放器支持接入网易云、QQ 音乐、酷狗、Navidrome也能导入本地音乐库。本安装教程覆盖三大系统的下载、安装与排障全流程第一次使用的用户跟着做几分钟就能装完。装之前先确认动手下载前先对照自己的情况Windows 或 Mac走安装包路线。桌面版内置前后端运行环境无需 Node.js也无需额外依赖装完即用。Arch / Manjaro有 AUR 包folia-major-bin一条命令完成。Debian / Ubuntu / Fedora 及其他发行版拿.deb、.rpm或linux-x64便携版 tar.gz解压后手动建桌面启动项。如果国内直连 GitHub Releases 页面速度慢有网盘镜像渠道见下一节。按系统选对安装包你的系统该拿的包Windows.exe安装包macOSApple silicon.dmg安装包选对应架构版本macOSIntel.dmg安装包Debian / Ubuntu.deb包Fedora / RHEL 系.rpm包其他 Linux 发行版linux-x64便携版 tar.gz正式渠道是项目的 Releases 页面。如果直连下载慢到掉线改用 README.md「直接下载」一节的夸克网盘或百度镜像提取码flia。网盘取包留意两点镜像只覆盖 Windows 与 Apple silicon 两个正式版安装包Intel Mac 和 Linux 都不在网盘里需要回 Releases 页面网盘版本会滞后于最新 release取下来先核对版本号。安装 Windows 版 .exe 包拿哪个包Releases 页面向 Windows 发布的.exe安装包网盘镜像版本合适时也可以用网盘的。安装步骤双击.exe按安装向导完成即可全程不依赖任何环境。装完验证在开始菜单找到 Folia 并启动主界面能正常渲染就算成功。安装 macOS 版 .dmg 包拿哪个包Releases 页面的.dmg安装包。Apple silicon 的 Mac 要选对应架构版本网盘镜像也有这一版但注意版本滞后。安装步骤双击.dmg把应用拖进应用程序文件夹。装完验证在启动台找到 Folia 启动主界面正常显示即可。AUR 一行装拿哪个包AUR 包folia-major-bin。安装步骤yay 或 paru 装好后执行用 paru 时命令相同yay -S folia-major-bin这个 AUR 包本质是薄封装构建时从 Releases 拉取folia-major-版本-linux-x64.tar.gz整体放进/opt/folia-major再建一个usr/bin/folia-major的链接。当前包版本 0.1.4依赖清单alsa-lib、gtk3、libxss、nss都能在 PKGBUILD 里核对。装完验证在终端输入folia-major启动或在应用菜单里找到它。如果构建长时间卡在下载步骤不用再等直接改用下文的便携版手动方式。安装 Debian 版 .deb 包拿哪个包Releases 页面的.deb包。安装步骤双击安装或用系统包管理工具安装。装完验证在应用菜单里找到 Folia 启动。安装 Fedora 版 .rpm 包拿哪个包Releases 页面的.rpm包。安装步骤双击或用系统包管理工具安装。装完验证从应用菜单启动确认主界面正常。手动部署 Linux 便携版这一节覆盖其他发行版和所有不在网盘镜像里的情况。便携版 tar.gz 里就三样东西folia-major可执行文件、resources/linux/icon.png图标、桌面模板resources/linux/folia-major.desktop。想让它出现在应用菜单里按这三步做把模板复制到~/.local/share/applications/folia-major.desktop打开复制出的文件把__APP_PATH__指向可执行文件和__ICON_PATH__指向图标两个占位符替换成实际绝对路径桌面环境若要求把这个文件标记为可信或可执行完整示例见 packaging/linux/README-LINUX.txt。首次启动后怎么验证安装是否成功用这三个动作判断主界面正常渲染没有黑屏或透明度异常导入一个本地音乐目录或登录网易云、Navidrome 等平台账号播放一首带逐字歌词的歌全屏歌词动画正常出现装不上按症状对号入座症状处理Linux 启动黑屏、透明度或模糊异常先换软件渲染FOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-majorswiftshader 下仍闪烁不稳再退到最保守的软件渲染FOLIA_LINUX_GRAPHICS_MODEsoftware ./folia-major网盘链接失效或版本过旧以 README.md「直接下载」一节的最新链接为准并核对版本号AUR 构建卡在下载步骤直接改用便携版手动部署网盘里没有你要的平台包Intel Mac / Linux回 Releases 页面直接取对应平台包FOLIA_LINUX_GRAPHICS_MODE只改变 Electron 在 Linux 上的启动参数不影响 Web 端与同步服务。排查渲染问题前先确认可执行文件和resources/仍在同一个便携包目录里。装好之后去哪看桌面项细节、Wayland 壁纸模式、遥控窗配置docs/technical.md想在手机或浏览器里用自托管 Web 版本Docker Compose 全栈方案见 deploy/docker/README.md本地音乐库的导入、重扫与在线匹配docs/local-library-management.md装完之后挑一首带逐字歌词的歌点播放看全屏动画效果。如果启动仍是黑屏回到上面的症状表再对一次。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考