Folia 全屏歌词播放器安装教程：10 分钟从下载到第一首歌词亮屏

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

Folia 是一个把歌词做成全屏动画的 Electron 音乐播放器，支持网易云、QQ 音乐、酷狗等在线音源，也支持 Navidrome 自建服务器和本地曲库。这篇教程只走一条最省事的主线：把桌面版装进系统、登录一个音源、放出第一首带歌词的歌。顺利的话，十分钟内第一首歌的歌词就会亮满整块屏幕，全程不用看一行代码。

🔍 装前先定音源：在线、Navidrome 还是本地曲库

装之前先想清楚歌从哪来，这一步决定你装完要做的第一件事：

• 在线音源：登录网易云、QQ 音乐或酷狗里任意一个，搜索即放，封面和歌词自动加载。绝大多数人选这条路。
• Navidrome：手里有自建音乐服务器的话，在设置里填服务器地址，直接拿它当曲库用。
• 本地曲库：导入一个本地音乐文件夹，Folia 递归扫描建库，只读取元数据，音频文件不出本机。

三条路殊途同归：放一首带歌词的歌，全屏歌词动画自动点亮。

🚀 三个系统装桌面版：Windows、macOS 与 Linux

桌面版已内置前后端运行环境，不用预装 Node.js 或任何开发工具。

1. 下：进官方 Releases 页，按系统和芯片取包——Windows 拿.exe；Mac 先点「关于本机」认芯片，M 系列拿 Apple silicon 版.dmg，Intel 拿 Intel 版；Linux 拿对应架构的.tar.gz。

   ⚠️ 国内网络走官方网盘镜像更快，但它只收录 Windows 与 Apple silicon 两个版本；Intel Mac 和 Linux 包只能从 Releases 页取。

2. 装：Windows 双击.exe按向导一路下一步；macOS 双击.dmg把图标拖进 Applications，拖完即装好；Linux 解压后folia-major可执行文件直接能跑。 Arch / Manjaro 用户装了 yay 或 paru 一条命令解决，依赖自动处理，程序落进/opt/folia-major：

   yay -S folia-major-bin

3. 开：从开始菜单、Applications 或应用菜单里点进主界面。

两个常见卡点，先记住：

⚠️ macOS 首次启动提示「无法打开」，是 Gatekeeper 拦了未识别应用；右键应用图标选「打开」，弹窗里再确认一次即可放行。 ⚠️ Linux 启动黑屏、透明度异常或闪退，通常是 GPU 兼容问题而非装坏了；用FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major强制软件渲染，能开就证实是显卡相关。

✅ 首跑验证：登录、放歌、看歌词亮起来

1. 登录：进登录入口选一个音源，扫码或账号登录；走本地曲库的用户改为导入一个音乐文件夹，等扫描完成。
2. 放歌：搜索任意一首带歌词的歌并播放——全屏歌词动画自动亮起来，不用切任何开关。
3. 验证：两条判断，都成立就是跑通了——进「关于」页，版本号和你刚下的包一致，装对了；歌词在整块屏幕上逐句点亮，就是第一次成功画面。

跑通之后第一个动作：去设置里把歌词动画主题逐个切一遍，挑一个最合眼缘的，然后把整块屏幕交给歌。本地曲库导入与匹配的详细用法见本地音乐库管理，Linux 图形兼容与壁纸模式细节见 packaging/linux/README-LINUX.txt。

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