Folia 全屏歌词播放器三端完整安装指南：10 分钟一次跑通

Folia 全屏歌词播放器三端完整安装指南：10 分钟一次跑通

【免费下载链接】folia-major 专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器 A multi-platform music player for local files, Navidrome, and online streaming services, featuring stunning animated lyrics. 项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major

Folia 是一款以全屏沉浸式歌词动画为核心的音乐播放器，支持网易云、QQ 音乐、酷狗、Navidrome 与本地音乐库。本篇覆盖 Windows、macOS、Linux 三端，全程约 10 分钟，无需预装任何依赖，即装即用。

选包对照表：如何选对 Folia 安装包

到项目 Releases 页面按文件名选包，对照下表即可一次选对：

平台	推荐下载渠道	备注
Windows（64 位）	官方 Releases 页面，Folia-Setup-0.7.x.exe	国内下载慢可换 README「快速下载」的网盘镜像
Mac（Apple silicon，M 系列）	Releases 页面，arm64.dmg	网盘镜像同样提供此包
Mac（Intel）	仅 Releases 页面，x64.dmg	网盘镜像没有 Intel 包，拿错架构最容易出现"装完打不开"
Linux（x64）	仅 Releases 页面，folia-major-<版本>-linux-x64.tar.gz，另有 deb / rpm	网盘镜像没有 Linux 包
Arch Linux	AUR，folia-major-bin	一条命令装预构建版，跳过手动下载

分平台安装步骤

Windows 安装

1. 到 Releases 页面按文件名下载 Folia-Setup-0.7.x.exe
2. 双击安装包，向导默认选项一路走完
3. 开始菜单出现 Folia 入口即安装成功

macOS 安装

1. 确认芯片类型（左上角苹果菜单 →「关于本机」）：M 系列选 arm64.dmg，Intel 选 x64.dmg
2. 打开 .dmg，把 Folia 图标拖进「应用程序」文件夹
3. Launchpad 或访达「应用程序」里能看到 Folia 即安装成功

Linux 安装

1. 下载 folia-major-<版本>-linux-x64.tar.gz（或有 deb / rpm 倾向就选对应格式）
2. 解压到任意目录，无需安装步骤；Arch 用户直接 yay -S folia-major-bin，程序落在 /opt/folia-major
3. （可选）把包内 .desktop 模板复制到 ~/.local/share/applications/，替换 __APP_PATH__ 与 __ICON_PATH__ 两个占位符，应用菜单即出现入口，详见 packaging/linux/README-LINUX.txt

启动与首次验证：版本号在哪里核对

1. 启动应用：Windows 双击开始菜单入口，Mac 双击「应用程序」中的 Folia，Linux 运行解压目录内的 folia-major 可执行文件
2. 核对版本：打开「设置 → 帮助」，底部「版本」区显示 v0.7.x，与刚下载的包一致即成功
3. 最小体验：登录任一在线音源或导入一个本地文件夹，播放一首带歌词的歌，全屏歌词动画自动出现即说明核心功能可用

常见问题速查

现象	可能原因	处理方式
Linux 下黑屏、透明度异常或闪退	GPU 渲染兼容问题，不是装坏了	先切 SwiftShader 再启动：FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major
换 swiftshader 后仍不稳定	驱动过旧	把 swiftshader 改成 software 重试，走最保守的软件渲染路径
Intel Mac 装完打不开	从镜像拿错架构的包	回 Releases 页面按文件名逐字重选；镜像里没有 Intel 与 Linux 包
X11 下智能动感模式提示无 WebGPU	系统图形路径默认关闭 Vulkan	FOLIA_LINUX_VULKAN=1 ./folia-major --ozone-platform=x11（仅 X11 生效，Wayland 下无需设置）
下载速度慢	GitHub 直连受限	网盘镜像仅限 Windows 与 Apple silicon，其余平台回 Releases 页面

收尾与进阶

主路径就三件事：按表选包 → 安装解包 → 启动核对版本。跑通之后，这些方向值得继续探索：

• 换主题：「设置 → 配色」里切换全屏歌词动画主题，每种排版氛围都不一样，如 心象主题
• 自托管：Web 版或 NAS 部署见 deploy/docker/
• 本地音乐库进阶：导入、匹配、歌单管理见 docs/local-library-management.md
• 部署、环境变量与技术细节见 docs/technical.md

【免费下载链接】folia-major 专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器 A multi-platform music player for local files, Navidrome, and online streaming services, featuring stunning animated lyrics. 项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major