Folia 安装教程15 分钟装好全屏歌词动画播放器Windows、macOS、Linux 全支持【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major把歌词铺满整个桌面当壁纸是不少人的理想听歌场景。Folia 就是一个让歌词变成全屏动画的开源音乐播放器本地曲库、Navidrome、网易云、酷狗、QQ 音乐都能接进来歌词、封面自动补齐还能用 AI 按歌曲情绪生成配色主题。本文是一份 Folia 安装与首次配置指南桌面版自带完整运行环境不挑机器配置跟着走大约 15 分钟装完你就能管理自己的曲库并播放带逐字歌词的歌。先看看效果Folia 的招牌是把歌词做成占满全屏的动画舞台逐字高亮、排版随主题变化仓库里备好了「浮名」「云阶」「流光」等多套风格播放时自动切换逐字渲染。它还能根据歌曲内容生成背景与视觉参数让每首歌的歌词画面都不一样。桌面党还有壁纸模式把整个窗口沉到所有窗口之下歌词直接铺在桌面上切到别的应用也不会消失需要 Wayland 合成器支持wlr-layer-shellGNOME 不支持。动手前的准备检查Folia 安装之前先把下面四项过一遍能省掉大部分返工检查维度要求自查方式操作系统Windows、macOS、Linux 桌面均可系统设置里确认系统与架构网络能打开仓库 Releases 页即可国内网络慢可走网盘入口浏览器访问 README「快速下载」中的入口磁盘空间安装包数百 MB建议预留 1 GB 以上查看目标分区可用容量Linux 桌面环境X11 或 Wayland 均可终端执行echo $XDG_SESSION_TYPE输出x11或wayland都算通过安装方式怎么选Folia 安装路线一共有五条先对照下表做选择后文只展开第一条也是覆盖系统最广的一条路线支持的系统大约耗时特点官方 Releases 下载桌面包Windows / macOS / Linux10~15 分钟内置前后端运行环境即装即用本文主推网盘下载仅 Windows 与 macOSApple silicon10 分钟国内网络更快适合 Releases 下载慢的情况AUR仅 Arch Linux20 分钟一条命令自动拉包并安装Flatpak其他 Linux 发行版视网络而定社区第三方维护Web 部署服务器 / NAS视环境而定浏览器访问支持 Docker Compose 全栈主流路线分步操作第 1 步找到下载入口做什么打开仓库 README定位「快速下载」小节里面同时给出 GitHub Releases 入口和网盘入口。怎么判断做对了入口能打开页面列出了 Windows、macOS、Linux 各平台的安装包文件。没成功去哪里查README 同一小节里网盘入口的提取码是flia两条入口指向的是同一批版本版本号以 Releases 页最新条目为准。第 2 步按系统挑选安装包做什么Windows 选.exemacOS 选 Apple silicon 对应的.dmgLinux 选形如folia-major-版本号-linux-x64.tar.gz的压缩包。怎么判断做对了下载文件完整大小与 Releases 页标注一致没有中断重传。没成功去哪里查国内网络下载慢就改用「快速下载」里的网盘入口它只提供 Windows 与 Apple silicon 两个平台的正式包Linux 用户仍需走 Releases。第 3 步安装或解压到固定目录做什么Windows 与 macOS 双击安装包按向导装完即可Linux 把压缩包解压到一个不会随意移动的目录比如~/Apps/Folia。怎么判断做对了Linux 目录里能同时看到folia-major可执行文件和resources/资源目录两者缺一不可。没成功去哪里查目录结构不完整说明解压被中断重新下载解压路径规则见 packaging/linux/README-LINUX.txt。第 4 步启动应用做什么Windows 从开始菜单、macOS 从 Launchpad 找到 Folia 图标启动Linux 在终端执行cd ~/Apps/Folia ./folia-major怎么判断做对了应用窗口弹出出现全屏歌词界面。没成功去哪里查Linux 出现黑屏或透明度异常时换软件渲染模式启动命令见下方「常见卡点与处理办法」。第 5 步可选创建 Linux 桌面启动项做什么把解压目录里的模板resources/linux/folia-major.desktop复制到~/.local/share/applications/再把文件里的__APP_PATH__与__ICON_PATH__两个占位符替换为实际绝对路径。怎么判断做对了应用菜单里出现 Folia 一项双击能正常开窗。没成功去哪里查替换方法有完整示例见 packaging/linux/README-LINUX.txt部分桌面环境还需要把该.desktop文件标记为可信。其他系统的快捷通道网盘安装Windows / macOS Apple silicon适合国内网络直接下载对应系统安装包双击安装入口同样在 README「快速下载」小节。Arch LinuxAUR 一条命令yay -S folia-major-bin装完执行pacman -Qs folia-major能看到folia-major-bin条目即成功习惯用 paru 的把命令里的 yay 换成 paru。脚本会自动拉取 Linux 便携包并装到/opt/folia-major构建逻辑见 packaging/aur/folia-major-bin/PKGBUILD。Flatpak其他 Linux 发行版社区第三方维护包名folia-major从 Flatpak 商店或flatpak命令安装即可。Web 部署服务器 / NAS支持 Docker Compose 全栈默认只对外暴露 Web 网关与 Sync Server 两个端口完整步骤与端口说明见 deploy/docker/README.md。首次启动配置清单导入本地曲库。进入本地音乐区域选择「导入文件夹」支持 MP3、FLAC、M4A、WAV、OGG、Opus、AAC同目录的.lrc、.vtt、.ttml等歌词文件会被自动识别。预期效果曲库页列出全部歌曲且本地歌能自动匹配到在线歌词与封面。登录在线音乐账号。在登录页选择网易云、酷狗或 Navidrome 完成登录。预期效果在线搜索到的歌曲能直接播放右侧同步显示歌词与封面说明见 docs/local-library-management.md。播一首带逐字歌词的歌体验全屏歌词动画。预期效果歌词逐字高亮动画随主题排版变化。桌面党可选在「选项 → 桌面端」开启壁纸模式。预期效果切到其他应用时桌面仍显示歌词该模式切换后应用会自动重启。常见卡点与处理办法现象可能原因处理办法Linux 启动黑屏、透明度或模糊异常显卡渲染兼容问题 ⚠️先试软件渲染FOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-major仍不稳定改用FOLIA_LINUX_GRAPHICS_MODEsoftware ./folia-majorAUR 构建卡在下载压缩包Releases 拉取速度慢提前下载同版本 tar.gz 放进构建源码目录再执行makepkg -si网盘版本比最新版旧网盘镜像更新有延迟到 README「快速下载」入口核对版本号以 Releases 页为准启动报错或界面空白Linux可执行文件与resources/不在同一目录确认便携包目录结构完整详见 packaging/linux/README-LINUX.txt装完并配好曲库后日常从应用菜单启动即可之后有新版时走同一条路线重装版本号一律以仓库 README 与 Releases 页为准。下一步建议把壁纸模式试起来让歌词真正铺满你的桌面 【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
