Folia 安装指南5 分钟装好全屏歌词播放器三条路径一次装对【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-majorFolia 是一款以全屏歌词动画为核心的音乐播放器支持网易云、QQ 音乐、酷狗、Navidrome 和本地曲库。如果你在国内网络下从官方 Releases 拉安装包很慢或想在 Linux 上少折腾依赖这篇安装指南带你一次装对全程 5 到 15 分钟。动手前 30 秒自检先花 30 秒确认三件事选对路径能省一半时间系统类型Windows、macOSApple silicon走网盘Arch / Manjaro 等 AUR 系发行版走 AUR 助手Debian、Ubuntu 等其他 Linux 发行版用便携版网络状况国内网络访问官方 Releases 偏慢优先选网盘镜像打算装到哪里想直接进系统菜单选 AUR想解压即用、随时挪走选便携版想省事就网盘顺带一提桌面版内置前后端运行环境装完就能直接播放它提供流光、浮名等多套全屏歌词主题另有实验性 Folium 模组系统可以扩展歌词动画。选路指南按系统对号入座你的系统推荐路径需要准备预计耗时Windows网盘下载夸克或百度客户端账号5 分钟macOSApple silicon网盘下载夸克或百度客户端账号5 分钟Arch / Manjaro 等 AUR 系AUR 助手yay 或 paru约 15 分钟Debian / Ubuntu 等便携版 tar.gz一个自选目录10 分钟对完号之后直接跳到对应那一节从第一步开始做。Windows / macOS网盘下载步骤这条路径适合 Windows 和 macOS Apple silicon 用户全程不需要命令行。打开仓库 README.md 的「快速下载」一节里面给出夸克网盘与百度网盘两个入口百度网盘提取码flia只使用这里列出的官方链接别碰来路不明的第三方转发包用夸克或百度客户端登录把安装包转存到自己的网盘按平台挑文件Windows 选.exemacOS 选.dmgmacOS 用户确认是 Apple silicon 版本下载完成后双击安装桌面版内置前后端运行环境不需要额外配置怎么确认装好了打开 Folia切一首带歌词的歌全屏歌词动画正常滚动即说明装对了。Arch / ManjaroAUR 助手安装步骤AUR 是 Arch 社区的第三方软件源Folia 对应的包名是folia-major-bin构建会自动解析alsa-lib、gtk3、libxss、nss等依赖。确认系统装了 yay 或 paru 等 AUR 助手没有就先装一个执行安装命令yay -S folia-major-bin应用会落在/opt/folia-major并生成folia-major命令与系统菜单启动项包定义细节可看 PKGBUILD。怎么确认装好了终端输入folia-major回车主界面弹出来即成功应用菜单里也能找到 Folia 启动项。提速技巧国内网络构建默认从官方 Releases 拉folia-major-版本-linux-x64.tar.gz国内可能很慢甚至超时。先用网盘拿同版本压缩包放进构建源码目录srcdir再执行makepkg -si就能跳过慢速下载这一步。其他 Linux 发行版便携版解压即用Debian、Ubuntu 等发行版直接用tar.gz压缩包解压就是完整便携版不写系统目录。从官方 Releases 最新版本的folia-major-版本-linux-x64.tar.gz下载国内网络慢就改用网盘当前仓库版本为 0.7.23见 package.json解压到自选目录包内有folia-major可执行文件、resources/linux/icon.png图标和resources/linux/folia-major.desktop桌面启动项模板把.desktop模板复制到~/.local/share/applications/folia-major.desktop打开复制后的文件把__APP_PATH__与__ICON_PATH__两个占位符替换成实际绝对路径桌面环境有要求时再标记为可信完整步骤见 README-LINUX.txt。怎么确认装好了在解压目录运行./folia-major主界面弹出即部署成功。装完之后切一首带歌词的歌把全屏歌词动画拉满先确认动画、字体渲染都正常进登录页配一个音乐源账号网易云 / QQ / 酷狗 / Navidrome再连本地曲库之后选歌就方便了想玩点不一样的可在「选项 → 桌面端」开启壁纸模式把歌词动画铺到桌面上需要 Wayland 合成器支持wlr-layer-shellGNOME 不支持踩坑记录问AUR 构建卡在 tar.gz 下载或提示 404答AUR 包版本可能落后于官方最新版。先核对版本号再用上面的预拉取技巧把 tar.gz 提前放进构建目录再执行makepkg -si。问网盘里的版本比预期旧答镜像未必跟得上最新 release动手前对一眼版本号到官方 Releases 页面比对后再决定是否替换。问其他发行版装完应用菜单里没有启动项答依次核对三点——.desktop文件是否在~/.local/share/applications/下、__APP_PATH__与__ICON_PATH__两个占位符是否已替换、文件是否标记为可执行。问Linux 启动后黑屏、透明度/模糊异常或 GPU 崩溃答用软件渲染模式启动FOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-major仍不稳定则改用FOLIA_LINUX_GRAPHICS_MODEsoftware恢复系统图形路径用FOLIA_LINUX_GRAPHICS_MODEsystem。问想用 beta / alpha 通道答网盘只同步正式版想体验测试通道只能走官方 Releases 页面参考 docs/technical.md 的更新通道说明。装好只是起点打开 Folia 切上一首带歌词的歌把全屏歌词动画拉满。想继续深挖看这两份仓库内文档deploy/docker/README.md 用 Docker Compose 自托管 Web 版手机浏览器直接听docs/technical.md 讲技术架构、Wayland / Hyprland 遥控窗与桌面端细节。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
