Folia 全屏歌词播放器安装：从下载到第一首歌词点亮
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
Folia 是一款把歌词做成全屏动画的 Electron 音乐播放器，支持网易云、QQ 音乐、酷狗等在线音源，也支持 Navidrome 和本地曲库。本教程只带你完成 Folia 安装并放出第一首歌。顺利的话，十分钟以内第一首歌词就能亮满整块屏幕。
🧭 Folia 安装前：三件事确认到位
看系统：Windows、macOS、Linux 各有一套桌面版安装包，装前选定自己的那份。看芯片：Mac 分 Intel 与 Apple silicon，Linux 分 x64 与 ARM，两个架构的包不通用。看网络：从 Releases 页取包慢的话可以走官方网盘镜像，但镜像只收录 Windows 与 Apple silicon 两个版本。
依赖方面什么都不用装：桌面版已内置前后端运行环境，不需要 Node.js 或任何开发工具。
🖥️ Folia 最快安装路径：Windows 版
- 下：从 Releases 页取最新的 Windows
.exe，国内网络可改走 README.md「快速下载」一节的网盘镜像。⚠️ 网盘镜像只收录 Windows 与 Apple silicon 两个包，且有时比 Releases 页晚一个版本。下载前对一下文件名里的版本号，对不上就先等等。
- 装：双击
.exe，向导一路下一步。 - 开：开始菜单找到 Folia，进主界面。
- 放：登录网易云、QQ 音乐或酷狗任一个音源，也可以导入本地文件夹建曲库，播放一首带歌词的歌——全屏歌词动画会自动点亮。
🗺 其他路径速览：macOS、Linux 与 Web 版
macOS：先经苹果菜单「关于本机」认芯片。Apple M 系列取 Apple silicon 版.dmg，Intel 芯片去 Releases 页取 Intel 版。双击.dmg，把应用图标拖进 Applications，拖完即装好。
⚠️ 首次启动提示「无法打开」是 Gatekeeper 拦了未签名应用，右键图标选「打开」、弹窗里再确认一次即可放行。
Linux：Arch / Manjaro 装了 AUR Helper 的一条命令装好：
yay -S folia-major-bin预构建包从 AUR 拉取，alsa-lib、gtk3等依赖自动解决。其他发行版从 Releases 页取对应架构的.tar.gz，解压后folia-major直接可执行；想要桌面菜单入口，用 packaging/linux/folia-major.desktop 模板替换__APP_PATH__、__ICON_PATH__两个占位符，细节在 packaging/linux/README-LINUX.txt。
⚠️ 启动后黑屏、透明度异常或闪退多为 GPU 兼容问题：
FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major强制软件渲染，能起来就是显卡相关；排查完设FOLIA_LINUX_GRAPHICS_MODE=system恢复默认路径。
Web 版：面向 NAS 或手机时，把仓库一键部署到 Vercel 或 Cloudflare，或走 deploy/docker/ 的 Docker Compose 全栈部署；浏览器里把网页加到主屏幕，当 PWA 用。
✅ Folia 跑通验证：两条自测条件
- 版本对得上：进「关于」页，版本号与刚下载的安装包一致，就是装对了。
- 歌词亮起来：播放一首带歌词的歌，全屏歌词动画自动点亮——这就是你的第一次成功画面。
安装到这就结束了。下一步去设置里把歌词动画主题逐个切一遍，挑一个最合眼缘的；主题预览见 README.md，本地曲库用法见 docs/local-library-management.md。
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
