Folia 全屏歌词播放器装完即用的完整指南

Folia 全屏歌词播放器装完即用的完整指南

【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major

刚装完 Folia，启动后一片黑、版本号比最新版还旧，多半是包拿错了或渲染没兜住。Folia 是一款主打全屏歌词动画的开源播放器，支持本地曲库、Navidrome 与多个在线平台，这篇按「判断环境 → 动手装 → 确认成功 → 排错」的顺序走一遍，装完你就能在屏幕上看到歌词从中间浮起。

先认环境，再决定去哪拿包

你的系统决定了安装包形态，认准这三类再动手：

• Windows x64 / Apple silicon 的 macOS：走官方网盘或 Releases 的桌面安装包，双击即可。
• 其他 Linux x64（Wayland 或 X11 均可）：走 Releases 的便携 tar.gz，解压即用。
• Arch Linux：走 AUR 包folia-major-bin，前提是机器上已有 yay 或 paru。

⚠️ 别从 README 之外的渠道拿 Windows/macOS 包，第三方转发包容易夹带旧版本或脏文件。

Windows 和 macOS：双击装完

打开仓库 README.md 的「快速下载」一节，里面是夸克网盘和百度网盘两个官方入口，百度网盘提取码flia。流程：

1. 先用网盘客户端登录，把安装包转存到自己的网盘再下载，比直链稳。
2. Windows 拿.exe，macOS 拿.dmg，双击后一路默认。
3. 装完双击桌面图标启动。

✅ 看到搜索框和播放界面、播一首歌歌词从屏幕中间浮起，就算装好了。

⚡ 网盘只有 Windows 与 Apple silicon 的包，且同步有延迟；下载前先看一眼版本，对不上就直接去 Releases 页面拿最新版（仓库当前版本为 0.7.23，以 Releases 页面实际放出为准）。

Linux x64：解压便携包直接跑

Linux 包不在网盘里，去 Releases 页面拿folia-major-<版本>-linux-x64.tar.gz。

1. 解压到一个固定目录，别放会被清空的临时路径，后面桌面启动项要靠这个路径。

2. 进入含可执行文件的目录，跑起来：

   ./folia-major

窗口弹出、全屏歌词正常渲染就是成功。

顺手加个桌面启动项：压缩包里有现成的模板，把它复制到~/.local/share/applications/folia-major.desktop，再把里面的__APP_PATH__和__ICON_PATH__两个占位符改成绝对路径即可，示例写法见 packaging/linux/README-LINUX.txt。

⚡ 启动项要等可执行文件路径固定后再配，目录一挪，.desktop里的路径就失效了。

Arch：一行命令交给 AUR

yay -S folia-major-bin

用 paru 的话把 yay 换成 paru，其余不变。alsa-lib、gtk3、libxss、nss这些依赖会自动处理。验证方式：

pacman -Qs folia-major-bin

能列出包条目、从应用菜单打开后弹出全屏歌词界面即成功。

⚡ 构建时会去拉 Releases 的 Linux 压缩包，下载慢的话，提前把同版本 tar.gz 放进 AUR 构建源码目录再跑makepkg -si，逻辑见 packaging/aur/folia-major-bin/PKGBUILD。

首启黑屏、透明发虚，这样修

这是 Linux 上最常见的显卡渲染兼容问题，按顺序试：

1. 先强制走 swiftshader 路径：

   FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major

2. 仍不稳定就换最保守的软件渲染，把值改成software；想恢复系统图形路径则设为system。

3. 原生 Wayland 下不需要额外动作；只在 X11 下提示没有可用 WebGPU 时，才用FOLIA_LINUX_VULKAN=1 ./folia-major --ozone-platform=x11手动开 Vulkan。这些变量的完整说明见 packaging/linux/README-LINUX.txt。

装完先跑三件事

• 播一首在线歌曲，确认全屏歌词动画和 AI 主题配色生成都正常。
• 导入一个本地音乐文件夹或连上 Navidrome，本地歌曲会自动匹配在线歌词与封面，细节见 docs/local-library-management.md。
• 仓库mods/目录内置了示范模组，想换歌词动画风格，到「设置 → 模组」里开启模组系统挑一个装上。

把上面三件事过完，这台机器上的 Folia 就算彻底落地了：下次打开它，屏幕中间应该已经有一行歌词在等你了 🎵

【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major