Folia 安装与首次上手教程：三步装好全屏歌词动画播放器并跑通
【免费下载链接】folia-major 专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器 
项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
Folia 是一款以全屏沉浸式歌词动画为核心的开源播放器，支持本地音乐库与网易云、酷狗、Navidrome 等在线平台，能自动匹配歌词并用 AI 生成配色主题。本文带你从零完成 Folia 安装：拿官方包、装进系统、放出第一曲全屏歌词，全程不超过 20 分钟。
先定位你的环境
- Windows：走官方网盘入口，双击安装。
- macOS（Apple silicon）：同上，双击安装；Intel Mac 用项目 Releases 页的 macOS 包。
- 主流 Linux（Ubuntu、Debian 等，非 Arch）：解压官方 Linux 便携压缩包即运行。
- Arch 或 Arch 系发行版（Manjaro、EndeavourOS 等）：AUR 一条命令安装。
动手前的两个准备
记牢官方入口：Windows 与 Apple silicon 用仓库 README「快速下载」小节的官方夸克、百度网盘入口（百度提取码 flia）；Linux 包没有网盘版，去项目 Releases 页取 folia-major-<版本>-linux-x64.tar.gz。只从这些官方入口下载，避开来路不明的转发包。
核对网络与工具：国内网络访问 Releases 慢时，Windows 和 macOS 用户改走网盘；Arch 用户在构建时也会拉同一份压缩包，构建慢属正常。桌面版内置前后端运行环境，不用另装 Node 等运行时。
Windows 与 macOS 双击安装装法
打开仓库 README「快速下载」小节，找到官方网盘入口并登录网盘。
把 Windows 的 .exe 安装包（macOS Apple silicon 为 .dmg）转存到自己网盘再下载，先转存可减少断线。
双击安装包走完安装；桌面版已内置前后端环境，无需额外配置。
从开始菜单（macOS 用 Launchpad）的 Folia 图标启动，看到全屏歌词界面即算通过。
Linux 解压到固定目录即跑 🐧
网盘没有 Linux 包，到项目 Releases 页下载 folia-major-<版本>-linux-x64.tar.gz，版本号以仓库 README 为准。
解压到固定目录（例如 ~/Apps/Folia），之后不要搬动这个目录。
双击目录里的 folia-major 可执行文件，弹出应用窗口即算通过。
（可选）创建桌面启动项：把解压目录中 resources/linux/folia-major.desktop 复制到 ~/.local/share/applications/，再把文件里的 __APP_PATH__ 与 __ICON_PATH__ 换成实际绝对路径，改法见 packaging/linux/README-LINUX.txt；应用菜单出现 Folia 项即算通过。
Arch 系一条命令 AUR 安装装法
确认装有 yay 或 paru 这类 AUR Helper。
执行 yay -S folia-major-bin（习惯用 paru 的把 yay 换成 paru），构建会自动从 Releases 拉取 Linux 压缩包，alsa-lib、gtk3、nss 等依赖一并装好，构建脚本可查 packaging/aur/folia-major-bin/PKGBUILD。
程序装进 /opt/folia-major，终端多出 folia-major 命令，可直接键入启动。
执行 pacman -Qs folia-major，看到 folia-major-bin 条目且应用菜单出现 Folia 即算通过。
第一次打开做什么 🎬
登录一个在线音乐账号（网易云、酷狗等），或导入本地音乐目录——Folia 读取音频同目录的元数据与歌词，文件内容不上传。
搜索一首带歌词的歌播放：歌词自动匹配、全屏动画开跑；「设置」里可开启 AI 主题生成，让每首歌的背景与歌词情绪相配。
常见卡点三句定位 🔧
Linux 启动黑屏、透明度或模糊异常 → 显卡渲染兼容问题 → 用软件渲染启动：FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major。
AUR 构建卡在下载压缩包 → Releases 拉取速度慢 → 提前备好同版本 tar.gz 放进构建源码目录，再执行 makepkg -si。
网盘版本与最新版对不上 → 网盘镜像更新有延迟 → 到 Releases 页核对版本号，镜像更新后从官方入口重新下载。
版本号一律以仓库 README 与 Releases 页为准，有新版时按同一入口重装即可，祝你早日听到全屏歌词 🎵
【免费下载链接】folia-major 专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器 项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
