Folia 全屏歌词播放器从下载到首次播放：3 端 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 与本地音乐库的全屏沉浸式歌词播放器，解决的是电脑上边听歌边看歌词这件事。这篇文章面向只想「下下来、打开、播放一首歌」的零基础用户：全程无需预装任何依赖，约 10 分钟，覆盖 Windows、macOS 与 Linux 三端。
🧭 选路分流：3 行定走哪条
- 如果你用 Windows 64 位或 Apple 芯片 Mac → 走项目 Releases 页面或网盘镜像
- 如果你用 Intel Mac 或 Linux → 走 Releases 页面下载对应架构包
- 如果你在 Arch Linux → 走 AUR 一条命令装预构建版
- 如果你的网络到 GitHub Releases 慢 → 走 README「快速下载」的夸克 / 百度网盘镜像（仅覆盖 Windows 与 Apple silicon）
拿包、安装与启动
拿到安装包
- Windows：64 位
.exe，文件名形如Folia-Setup-0.7.x.exe - macOS：Apple 芯片选
arm64.dmg，Intel 选x64.dmg - Linux：
folia-major-<版本>-linux-x64.tar.gz，另有deb与rpm - Arch：一条命令装预构建版，程序落在
/opt/folia-major
yay -S folia-major-bin做完这步你应该拿到一个与你的系统和架构匹配的安装包，或 AUR 安装完成。
安装或解包
- Windows：双击
.exe，向导默认选项一路走完 - macOS：打开
.dmg，把 Folia 图标拖进「应用程序」文件夹 - Linux：无需安装，把 tar.gz 解压到任意目录；Arch 已在
/opt/folia-major装好
做完这步你应该看到：Windows 开始菜单出现 Folia 入口，macOS「应用程序」里出现图标，Linux 解压目录里有folia-major可执行文件。
启动 Folia
- Windows：开始菜单找到 Folia 入口，双击启动
- macOS：Launchpad 或访达「应用程序」里双击启动
- Linux：运行解压目录内的
folia-major可执行文件
做完这步你应该看到窗口打开、主界面加载出来，而不是黑屏。
建 Linux 桌面启动项（可选）
- 把包内
resources/linux/folia-major.desktop模板复制到~/.local/share/applications/ - 将文件里的
__APP_PATH__与__ICON_PATH__两个占位符替换为实际绝对路径 - 桌面环境有要求时，把该
.desktop文件标记为可信
做完这步你应该看到应用菜单里出现 Folia 入口，模板细节见 packaging/linux/README-LINUX.txt。
🎧 首次播放验证
最小可用体验：登录任一在线音源，或导入一个本地文件夹，播放一首带歌词的歌，全屏歌词动画会自动出现。
- 版本号：设置 → 帮助，底部「版本」区 → 应显示与你下载的安装包一致（如
v0.7.25） - 歌词动画：搜索并播放一首带歌词的歌 → 全屏歌词动画自动出现
- 音源加载：登录网易云 → 首页与歌单列表正常加载
黑屏排障速查
如果 Linux 下黑屏、透明度异常或闪退：先切 SwiftShader 渲染再启动，这是 GPU 兼容问题，不是装坏了。
FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major如果换渲染后仍不稳定：先把swiftshader改成software重试，走最保守的软件渲染路径。
FOLIA_LINUX_GRAPHICS_MODE=software ./folia-major如果 Intel Mac 装完打不开：先回 Releases 页面按文件名逐字重选x64.dmg一次，网盘镜像没有 Intel 包，拿错架构最容易出现这个症状。
下一步
主路径到此跑通：选包 → 安装 → 启动 → 核对版本。跑通之后，去「设置 → 配色」换几个全屏歌词动画主题，每种排版氛围都不一样。
想要网页版或 NAS 自托管，看 deploy/docker/ 的说明。
【免费下载链接】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
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
