Folia 安装指南:Windows / macOS / Linux 从下载到启动【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-majorFolia 是把歌词渲染成全屏动画的开源音乐播放器。本文只讲 Folia 安装:Windows 与 macOS 装现成安装包,Arch 走 AUR,其他 Linux 发行版手动部署,附装完验证与黑屏排查。下载 Folia 安装包:官方 Releases 与网盘镜像怎么选Folia 安装包统一放在项目的 Releases 页面。直连 GitHub 慢或频繁掉线时,转去 README「直接下载」 一节,那里有夸克网盘与百度网盘两个镜像,百度提取码flia。先对照下边这张表确认你的系统该取什么:你的系统Releases 里取网盘镜像有无Windows.exe安装包有macOS(Apple silicon).dmg安装包有macOS(Intel).dmg安装包无,回 Releases 取Linux.deb/.rpm/linux-x64的tar.gz无,回 Releases 取下之前核对两件事:网盘镜像只覆盖 Windows 与 Apple silicon 两个正式版安装包,Intel Mac 和 Linux 不在其中。网盘里的版本会滞后于最新 release,下载后先对一眼版本号再装。Windows 与 macOS 安装 Folia:选包、安装、打开三步走桌面版内置了前后端运行环境,装完即用,不需要 Node.js,也不需要额外装任何依赖。选对包:Windows 取.exe;macOS 取.dmg,Apple silicon 的机器注意选对应架构的版本。安装:运行安装包,按提示走完即可,全程无额外依赖。打开确认:启动应用,确认主界面正常加载、能搜到歌,安装就算完成。Linux 安装 Folia:AUR 命令与便携版部署两条路Arch / Manjaro:Folia AUR 安装一行命令yay 或 paru 装好后执行:yay -S folia-major-bin # 用 paru 时命令相同这个 AUR 包做的事很简单:构建时去 Releases 拉取folia-major-版本-linux-x64.tar.gz,整体放进/opt/folia-major,再建一个usr/bin/folia-major的链接。当前包版本 0.1.4,依赖清单(alsa-lib、gtk3、libxss、nss)都能在 PKGBUILD 里逐项核对。一个提示:如果构建长时间卡在下载步骤,那就是「国内访问 GitHub 慢」的同一个网络问题。挂着等没有意义,直接转下面的手动部署路线。其他发行版:手动部署 .deb / .rpm / tar.gzDebian / Ubuntu 取.deb包,Fedora / RHEL 系取.rpm,都不合适就取linux-x64的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。装完 Folia 后的快速验证:放一首逐字歌词的歌安装流程走完不等于装好了。放一首带逐字歌词的歌,全屏歌词动画能正常动起来,说明 Folia 安装到位。Linux 下如果一启动就黑屏、透明度或模糊异常,不用逐项自查,直接跳到下一节的渲染参数,两条命令就能定位问题。Folia 故障排查:黑屏、卡下载、镜像失效怎么处理按序号对号入座:Linux 启动黑屏、透明度或模糊异常→ 先换软件渲染:FOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-majorswiftshader 下仍闪烁不稳→ 退到最保守的软件渲染:FOLIA_LINUX_GRAPHICS_MODEsoftware ./folia-majorAUR 构建卡在下载步骤→ 别挂着等,改走便携版手动部署网盘链接失效或版本过旧→ 以 README「直接下载」一节的最新链接为准,并核对版本号网盘里没有你要的平台包(Intel Mac / Linux)→ 回 Releases 页面直接取对应平台包补充说明:FOLIA_LINUX_GRAPHICS_MODE只改变 Electron 在 Linux 上的启动参数,不影响 Web 端与同步服务;排查渲染问题前,先确认可执行文件和resources/仍在同一个便携包目录里。延伸阅读:Folia 技术文档、Docker 自托管与本地库管理桌面项细节、Wayland 壁纸模式、遥控窗配置:docs/technical.md想在手机或浏览器里用:自托管 Web 版本,Docker Compose 全栈方案见 deploy/docker/README.md本地音乐库的导入、重扫与在线匹配:docs/local-library-management.md装好之后,下一步去登录页连上网易云、QQ 音乐这类音源,或把本地文件夹导进音乐库,给动画找点内容。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考