Folia 安装教程：10 分钟跑通全屏歌词动画播放器
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
Folia 是一个把全屏歌词动画当主角的开源音乐播放器：既能管理你自己的本地曲库，也能接入 Navidrome、网易云、酷狗等在线音源，还会根据歌曲内容用 AI 生成配色主题。歌词不只是滚动，而是整屏地「动」起来。
这篇带你从零把桌面版装上并启动，再跑通三个核心功能。环境没坑的话，大约 10~20 分钟能走完。做完之后，你自己的电脑上就能出现全屏歌词、歌也能正常放。
先花 30 秒确认几件事
- 你的系统是 Windows、macOS 还是 Linux？桌面版三个平台都有，在系统设置里查一下版本和架构就行。Linux 用户再开终端跑一句
echo $XDG_SESSION_TYPE，输出x11或wayland都没问题。 - 能不能打开项目仓库的 Releases 页？那是下载安装包的入口。国内网络慢的话，README 里备了网盘入口可以换道走。
- 磁盘空不空？安装包本身几百 MB，应用运行起来还会再占一些，留 1 GB 左右可用空间比较稳。
桌面版安装：从下载到启动
第 1 步：拿到对应平台的安装包
打开仓库里的 README.md，翻到「快速下载」小节：GitHub Releases 入口提供 Windows、macOS、Linux 全平台包；网盘入口（夸克网盘、百度云，提取码flia）只有 Windows 和 Apple silicon 的正式版，适合国内网络。
按系统挑文件：Windows 选.exe，macOS 选.dmg（Apple silicon），Linux 选folia-major-<版本>-linux-x64.tar.gz，版本就取 Releases 页上最新的那条。
下载没中断、文件大小和页面上显示的一致，这步就成了。
第 2 步：安装或解压
- Windows 和 macOS：双击安装包，跟着提示一路装完即可。
- Linux：把 tar.gz 解压到一个固定目录，比如
~/Apps/Folia。
解压完进到目录里，看到folia-major可执行文件和resources/目录，说明装得对。
第 3 步：启动应用
Windows 从开始菜单找 Folia，macOS 在 Launchpad 里点 Folia 图标。Linux 打开终端执行：
cd ~/Apps/Folia ./folia-major窗口弹出来、能看到全屏歌词界面，安装就算跑通了。
可选：给 Linux 加个桌面启动项
不想每次都敲命令的话，把解压目录里的resources/linux/folia-major.desktop复制到~/.local/share/applications/folia-major.desktop，再把文件里的__APP_PATH__替换成folia-major可执行文件的绝对路径、__ICON_PATH__替换成resources/linux/icon.png的绝对路径。细节看 packaging/linux/README-LINUX.txt。过关标准：应用菜单里出现 Folia，点一下能开窗。
其他安装方式（对号入座即可）
- AUR（Arch Linux）：
yay -S folia-major-bin，会自动拉 Linux 便携包装到/opt/folia-major，之后pacman -Qs folia-major能看到folia-major-bin就是装上了；用 paru 的话把 yay 换掉即可。 - Flatpak（其他 Linux 发行版）：社区第三方维护，包名
folia-major。 - Web 版（服务器 / NAS）：Docker Compose 全栈，浏览器访问，构建细节见仓库里的
deploy/docker/README.md。
装完就去玩这三个功能
1. 先听一首带逐字歌词的歌
这是 Folia 最有存在感的体验：随便找一首带逐字歌词的歌（本地有就放本地，没有就先登在线账号搜一首），按下播放，看歌词在整块屏幕上动。看到它，整条链路才算真正通了。
2. 导入你的本地曲库
MP3、FLAC、M4A、WAV 都能识别，同目录下的.lrc文件（track.lrc或track.mp3.lrc两种命名都行）会被当成歌词自动挂上。更完整的规则见本地曲库说明。曲库页面里看到导入的歌曲列表，就成了。
3. 登录在线账号，在线搜索带歌词
在登录页选网易云、酷狗或 Navidrome 登录。之后在线搜到的歌会自动带上歌词和封面。搜一首歌能放、右侧出歌词，就算接通了。
顺手看看 AI 生成的主题
Folia 会根据歌曲内容生成配色主题，多听几首就能翻出它给不同歌做的视觉风格，喜欢哪个用哪个。
出问题时先查这里
Linux 一启动就黑屏，或者透明度、模糊不对劲？多半是显卡渲染兼容问题。换软件渲染模式启动：
FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major还嫌不稳就退到最保守的FOLIA_LINUX_GRAPHICS_MODE=software，变量含义在packaging/linux/README-LINUX.txt里有写。
AUR 构建卡死在下载压缩包？是 Releases 拉取慢导致的。提前把同版本的 tar.gz 备下来，放进构建源码目录，再执行makepkg -si就能跳过慢的那段。
网盘里的版本和最新版对不上？网盘镜像更新有延迟，去 Releases 页核对一下版本号，下对应的那份。
Linux 上开不了壁纸模式？壁纸模式是把整个窗口沉到所有窗口之下当桌面歌词，Linux 上要 Wayland 合成器支持wlr-layer-shell，GNOME 不支持。机制细节见 docs/wallpaper-mode.md。
到这里，收尾
把对的平台包拿回来、装上（Linux 是解压）、启动，全屏歌词就在了；想日常用，本地曲库导进来或在线账号登上。之后出了新版，照同一条路重走一遍就行。去把那首惦记很久的逐字歌词歌放起来吧 🎵
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
