Folia 全屏歌词动画播放器国内下载与安装指南三条路线约 10 分钟跑起来【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-majorFolia 是一款以全屏沉浸式歌词动画为核心的开源音乐播放器支持网易云音乐、酷狗、QQ 音乐、Navidrome 与本地音乐库还带 AI 主题生成与智能歌词匹配。本文面向想把工具装起来、跑起来的用户走一遍 Folia 国内下载与安装的三条路线Windows 和 macOS 走官方网盘镜像约 5 分钟装完Linux 用官方便携版或 AUR 一条命令约 10 分钟。照做完你能启动播放器、搜到任意歌曲并看到全屏歌词动画。先判断走哪条 Folia 安装路线环境对照表不确定选哪条就先看这张表关键就两个问题系统是什么、是不是 Arch。环境推荐路线安装形态预计耗时Windowsx64官方网盘镜像.exe安装包约 5 分钟macOSApple silicon官方网盘镜像.dmg镜像约 5 分钟非 Arch 的 LinuxUbuntu / Debian / Fedora 等官方 Linux 便携版.tar.gz解压即用约 10 分钟Arch LinuxAURfolia-major-binAUR Helper 一条命令约 10 分钟⚠️ 只使用 README.md「快速下载」小节列出的官方网盘入口不要下载来路不明的第三方转发包。Windows 与 macOS网盘镜像完成 Folia 安装适用环境Windows x64 与 macOSApple silicon。官方网盘镜像只承载这两个平台的正式版安装包对多数用户来说正好够用。操作步骤打开 README.md定位「快速下载」小节里面有夸克网盘与百度网盘两个官方入口百度网盘提取码为flia。用网盘客户端登录后先把安装包转存到自己的网盘再开始下载中转更稳不容易断流速度按网盘正常水平走不限速。按系统取文件Windows 拿.exe安装包macOS 拿.dmg镜像双击后按提示装完即可。装完后的可验证结果开始菜单Windows或 LaunchpadmacOS里会出现 Folia 图标。点击启动后主界面正常出现搜索框与封面轮播都可见就说明这一环节通了。非 Arch LinuxFolia 便携版安装步骤解压即用适用环境Arch 以外的 Linux 发行版Ubuntu、Debian、Fedora 等。不需要 root、不装任何依赖解压即用。操作步骤前往官方 Releases 页面README.md「获取方式」小节有入口下载folia-major-版本-linux-x64.tar.gz版本号以页面显示为准。解压到任意固定目录。便携包内含folia-major可执行文件、resources/linux/icon.png图标和桌面启动项模板。# 解压 Folia Linux 便携版文件名换成你实际下载的版本号 tar -xzf folia-major-0.1.4-linux-x64.tar.gz双击解压目录里的folia-major可执行文件启动。可选创建桌面启动项把模板复制到用户级应用目录再把文件里的__APP_PATH__与__ICON_PATH__两个占位符替换为实际路径。# 把桌面启动项模板复制到用户级应用目录 cp resources/linux/folia-major.desktop ~/.local/share/applications/folia-major.desktop替换写法在 packaging/linux/README-LINUX.txt 里给了完整示例如果桌面环境有要求把复制后的.desktop标记为可信或可执行。装完后的可验证结果在解压目录执行./folia-majorFolia 窗口正常弹出、画面无黑屏应用菜单里能找到 Folia 启动项。Arch LinuxAUR 一条命令安装 folia-major-bin适用环境Arch Linux。构建交给 yay 这类 AUR Helper 自动完成不用手工处理依赖。操作步骤没装过 AUR Helper 的先按 yay 文档装好yay --version能正常返回版本号即代表就绪。执行安装命令# 一条命令安装 folia-major-bin依赖由 yay 自动处理 yay -S folia-major-bin构建过程会自动拉取官方 Linux 便携包并装好alsa-lib、gtk3、libxss、nss等运行时依赖完整定义见 packaging/aur/folia-major-bin/PKGBUILD其中记录的版本号为 0.1.4。装完后的可验证结果终端跑完构建安装后应用菜单出现 Folia。再执行下面命令核对包条目# 核对 AUR 安装的包条目与版本号 pacman -Qs folia-major-bin输出包含folia-major-bin条目、且版本号与 AUR 页面一致即安装成功。30 秒验收清单确认 Folia 跑起来了无论走哪条路线都过一遍这份清单从开始菜单 / 应用菜单启动窗口弹出、无黑屏、透明度正常搜索并播放任意歌曲全屏歌词动画与封面加载正常AUR 安装pacman -Qs folia-major-bin输出带版本号的条目便携版在解压目录执行./folia-major窗口正常弹出排障速查黑屏、版本对不上与构建卡住现象原因处置启动后黑屏、模糊、透明度异常GPU 渲染兼容问题用软件渲染模式启动FOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-major仍不稳定再改software网盘里的版本和最新版对不上网盘镜像存在更新延迟以官方「快速下载」入口为准并在官方 Releases 页面核对版本号后再继续AUR 构建卡在拉包构建时拉取官方tar.gz网速慢手动放一份同版本folia-major-版本-linux-x64.tar.gz进构建源码目录再执行makepkg -si桌面启动项不出现.desktop文件未被标记可信将复制后的.desktop标记为可信或可执行写法见 packaging/linux/README-LINUX.txtLinux 图形变量还有更多组合如 X11 下手动开 Vulkan细节查 packaging/linux/README-LINUX.txt 与 docs/technical.md。装完之后接入音源与挑选全屏歌词主题装好后的第一件事是接音源进入设置选本地音乐库或登录网易云 / QQ / 酷狗等在线音源。本地曲库的导入、匹配与重扫说明见 docs/local-library-management.md部署、环境变量与 Stage API 等技术细节见 docs/technical.md。歌曲播放起来后挑一个喜欢的全屏歌词主题。每种动画模式的排版氛围与可调参数都不同能让全屏歌词拥有接近文字 PV 的视觉效果同时自动适配窗口尺寸。桌面版用户还可以尝试 Folium 模组系统在「设置 → 模组 → 模组系统」中开启后即可加装新的歌词动画、背景与播放页图层仓库 mods/ 目录里有多个官方示范模组可以直接参考。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
