Folia 全屏歌词播放器安装指南：10 分钟跑通第一首歌

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

Folia 是一款把歌词渲染成全屏动画的沉浸式音乐播放器，桌面版支持网易云、QQ 音乐、酷狗、Navidrome 和本地音乐库。装好之后，播放一首带逐字歌词的歌，整屏文字会跟着节奏动起来。本文带你完成三件事：选对安装包、完成安装启动、验证是否装好。

安装方式速览：按系统选路线

如果直连 GitHub Releases 下载很慢，可以改用 README.md「快速下载」一节的网盘镜像（夸克、百度云）。注意镜像只同步 Windows 与 Apple silicon 两个包，且版本通常滞后于最新 release，取回后先核对版本号再安装。

第一步：下载正确的 Folia 安装包

所有平台的安装包都从项目的 Releases 页面取最新版，选包时盯住两点：

• macOS 先看芯片：在「关于本机」里确认是 Apple silicon（M 系列）还是 Intel，两者包不通用，选错装不上；
• Linux 认准命名：便携包统一叫folia-major-<版本>-linux-x64.tar.gz，别拿成其他平台的文件。

再提醒一次网盘镜像的覆盖范围：只有 Windows 和 Apple silicon 两个正式版。Intel Mac 和所有 Linux 用户只能回 Releases 取包，网络慢就多点几次或换个时间。

第二步：安装并启动 Folia

Windows 与 macOS：双击安装，零依赖

桌面版已经把前后端运行环境打包在内，不用装 Node.js 或任何其他依赖，流程不超过三步：

1. 双击.exe（Windows）或挂载.dmg后拖入应用程序（macOS）；
2. 等待安装完成，桌面或启动台会出现 Folia 图标；
3. 双击图标启动，首页正常加载即安装成功。

Arch / Manjaro：AUR 一条命令

终端里执行：

yay -S folia-major-bin

folia-major-bin是个薄封装包：构建时从 Releases 拉取对应版本的folia-major-<版本>-linux-x64.tar.gz，整体放入/opt/folia-major，再创建usr/bin/folia-major链接。装完在终端敲folia-major即可启动。如果构建长时间卡在下载环节（本质还是国内连 GitHub 慢），中断它，改走下面便携版的路线。

其他 Linux：便携 tar.gz 部署

先把包解压到一个专用目录，可执行文件与resources/文件夹必须留在同一层，拆开后图标和桌面项都会失效：

mkdir -p ~/Apps/Folia tar -xzf folia-major-0.1.4-linux-x64.tar.gz -C ~/Apps/Folia

直接运行可执行文件启动：

~/Apps/Folia/folia-major

想要应用菜单里有图标，把包里的resources/linux/folia-major.desktop复制到~/.local/share/applications/，打开副本，将__APP_PATH__与__ICON_PATH__两个占位符分别替换为可执行文件和resources/linux/icon.png的绝对路径；部分桌面环境还会要求把该.desktop文件标记为可信或可执行。

第三步：三点验证 Folia 安装成功

1. 应用从安装包或应用菜单正常启动，首页渲染出来而不是黑屏；
2. 播放一首带逐字歌词的歌，全屏歌词动画正常跑动，底部播放条能控制播放与切歌；
3. Linux 上刚配置的桌面启动项出现在应用菜单中，点击能正常拉起应用。

接上网易云后的首页效果：

导入本地音乐库后的界面：

附录：Folia 安装问题自查表

写在最后

桌面启动项细节、Wayland 壁纸模式与遥控窗配置见 技术说明；想在手机或浏览器里继续听，可按 Docker 部署说明 自托管一套 Web 版本。装完挑一首带逐字歌词的歌，让整屏文字替它唱完 🎵

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