Folia 完整安装部署指南从零跑通全屏歌词动画【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-majorFolia 全屏歌词动画播放器支持网易云、QQ 音乐、酷狗、Navidrome 与本地音乐库。本文给出本机开箱、Linux 便携部署、Docker 自托管三条安装路线跟着做完能放出第一首歌。最短路四步看到歌词动画打开 README.md定位「快速下载」一节按平台取安装包——Windows 拿.exemacOS 拿.dmg——装上。启动 Folia无需任何配置。首页搜音源名登录账号或者不登账号直接打开本地音乐库导入一个音频目录。播放任意歌曲确认歌词以全屏动画渲染出来即算跑通。提前说网盘镜像只覆盖 Windows 与 Apple silicon 两个正式版安装包找不到你平台的包就跳去对应部署形态一节别在网盘里翻。上面四步只适用 Windows 与 macOS。Linux 桌面与 NAS 上的 Web 版是另外两条路形态不同解法也不同。本机开箱Windows 与 macOS 官方版下载与安装Windows 取.exe安装包macOS 取.dmg镜像M 系芯片选 Apple silicon 版本双击运行即可。下载前先在 README 的「快速下载」一节核对版本号网盘版本可能落后于最新 Releases装到旧版会白白浪费一轮排查时间。Intel Mac 的包不在网盘里直接去仓库 Releases 页面取便携包路线和 Linux 一致。Linux 便携部署AUR 一条命令或手动桌面项Windows 和 macOS 靠安装包一步到位Linux 没有统一安装包得先定交付形态Arch 用 AUR 现成包其余发行版走「解压 配桌面项」。Arch 捷径AUR 一条命令确认装好yay或paru执行yay -S folia-major-bin。助手会自动带上alsa-lib、gtk3、libxss、nss依赖把 Folia 部署到/opt/folia-major。构建脚本在 packaging/aur/folia-major-bin/本质是从 Releases 拉linux-x64.tar.gz重新打包——你的网络连 Releases 慢时构建会卡在下载步骤这时直接切到手动部署自己控制下载进度。其余发行版解压加配桌面项从仓库 Releases 页面取linux-x64.tar.gz解压到固定目录如~/Apps/Folia/别放临时目录。把包内resources/linux/folia-major.desktop复制到~/.local/share/applications/。打开复制出的文件把__APP_PATH__与__ICON_PATH__两处占位符替换为绝对路径。从应用菜单启动folia-major桌面项即生效。每一步的完整示例见 packaging/linux/README-LINUX.txt照着对一遍路径就不会错。三条本机路线到此结束。想让手机浏览器直接打开 Folia就换容器化自托管这条交付形态。Docker 一键部署 Web 自托管版到 NAS部署不需要源码只要两个文件新建空目录从仓库 deploy/docker/ 取compose.yaml和.env模板.env.example取回后改名.env放进去。openssl rand -hex 32 # 输出填入 .env 的 SYNC_TOKEN必填 docker compose up -d启动后浏览器访问http://NAS 地址:18080进入 Folia Web 版。各环境变量含义、端口分配、Navidrome 预置账号怎么配deploy/docker/README.md 有完整清单对着自己的网络环境逐项确认。别把SYNC_TOKEN留空同步服务不会启动AI 配置可以留空不影响放歌。容器栈起来后用浏览器放出第一首歌验证整条链路是否真的工作。装完自检放一首歌验证 ✅桌面版与 Web 版验证方式一致逐项勾选应用正常打开无黑屏界面渲染完整在线音源登录成功或本地音频目录导入成功任意歌曲播放歌词以全屏动画渲染同名.lrc/.vtt歌词文件被自动识别本地歌曲的封面与歌词自动在线补全五项全勾即安装完成。Folia 的核心卖点正是多套歌词动画主题加按歌曲 AI 生成配色背景放歌时顺手切几个主题看看差异。自检不通过时症状多半集中在这两处Linux 图形链路与下载源。两个高频卡点各配一行处理直接查表。高频卡点速查Linux 黑屏与构建卡住现象一行处理Linux 启动后黑屏、模糊或透明度异常FOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-major软件光栅化后仍不稳定换最保守的FOLIA_LINUX_GRAPHICS_MODEsoftware ./folia-majorAUR 构建卡在下载步骤跳过构建改走手动便携包部署路线提前说排查时先确认可执行文件与resources/位于同一便携包目录拆开来会出各种怪问题。这些变量只影响 Linux 桌面端启动参数不改 Web 版或同步服务配置。Wayland 壁纸模式、遥控窗等更深机制去 docs/technical.md 里挖。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Folia 完整安装部署指南从零跑通全屏歌词动画【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-majorFolia 全屏歌词动画播放器支持网易云、QQ 音乐、酷狗、Navidrome 与本地音乐库。本文给出本机开箱、Linux 便携部署、Docker 自托管三条安装路线跟着做完能放出第一首歌。最短路四步看到歌词动画打开 README.md定位「快速下载」一节按平台取安装包——Windows 拿.exemacOS 拿.dmg——装上。启动 Folia无需任何配置。首页搜音源名登录账号或者不登账号直接打开本地音乐库导入一个音频目录。播放任意歌曲确认歌词以全屏动画渲染出来即算跑通。提前说网盘镜像只覆盖 Windows 与 Apple silicon 两个正式版安装包找不到你平台的包就跳去对应部署形态一节别在网盘里翻。上面四步只适用 Windows 与 macOS。Linux 桌面与 NAS 上的 Web 版是另外两条路形态不同解法也不同。本机开箱Windows 与 macOS 官方版下载与安装Windows 取.exe安装包macOS 取.dmg镜像M 系芯片选 Apple silicon 版本双击运行即可。下载前先在 README 的「快速下载」一节核对版本号网盘版本可能落后于最新 Releases装到旧版会白白浪费一轮排查时间。Intel Mac 的包不在网盘里直接去仓库 Releases 页面取便携包路线和 Linux 一致。Linux 便携部署AUR 一条命令或手动桌面项Windows 和 macOS 靠安装包一步到位Linux 没有统一安装包得先定交付形态Arch 用 AUR 现成包其余发行版走「解压 配桌面项」。Arch 捷径AUR 一条命令确认装好yay或paru执行yay -S folia-major-bin。助手会自动带上alsa-lib、gtk3、libxss、nss依赖把 Folia 部署到/opt/folia-major。构建脚本在 packaging/aur/folia-major-bin/本质是从 Releases 拉linux-x64.tar.gz重新打包——你的网络连 Releases 慢时构建会卡在下载步骤这时直接切到手动部署自己控制下载进度。其余发行版解压加配桌面项从仓库 Releases 页面取linux-x64.tar.gz解压到固定目录如~/Apps/Folia/别放临时目录。把包内resources/linux/folia-major.desktop复制到~/.local/share/applications/。打开复制出的文件把__APP_PATH__与__ICON_PATH__两处占位符替换为绝对路径。从应用菜单启动folia-major桌面项即生效。每一步的完整示例见 packaging/linux/README-LINUX.txt照着对一遍路径就不会错。三条本机路线到此结束。想让手机浏览器直接打开 Folia就换容器化自托管这条交付形态。Docker 一键部署 Web 自托管版到 NAS部署不需要源码只要两个文件新建空目录从仓库 deploy/docker/ 取compose.yaml和.env模板.env.example取回后改名.env放进去。openssl rand -hex 32 # 输出填入 .env 的 SYNC_TOKEN必填 docker compose up -d启动后浏览器访问http://NAS 地址:18080进入 Folia Web 版。各环境变量含义、端口分配、Navidrome 预置账号怎么配deploy/docker/README.md 有完整清单对着自己的网络环境逐项确认。别把SYNC_TOKEN留空同步服务不会启动AI 配置可以留空不影响放歌。容器栈起来后用浏览器放出第一首歌验证整条链路是否真的工作。装完自检放一首歌验证 ✅桌面版与 Web 版验证方式一致逐项勾选应用正常打开无黑屏界面渲染完整在线音源登录成功或本地音频目录导入成功任意歌曲播放歌词以全屏动画渲染同名.lrc/.vtt歌词文件被自动识别本地歌曲的封面与歌词自动在线补全五项全勾即安装完成。Folia 的核心卖点正是多套歌词动画主题加按歌曲 AI 生成配色背景放歌时顺手切几个主题看看差异。自检不通过时症状多半集中在这两处Linux 图形链路与下载源。两个高频卡点各配一行处理直接查表。高频卡点速查Linux 黑屏与构建卡住现象一行处理Linux 启动后黑屏、模糊或透明度异常FOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-major软件光栅化后仍不稳定换最保守的FOLIA_LINUX_GRAPHICS_MODEsoftware ./folia-majorAUR 构建卡在下载步骤跳过构建改走手动便携包部署路线提前说排查时先确认可执行文件与resources/位于同一便携包目录拆开来会出各种怪问题。这些变量只影响 Linux 桌面端启动参数不改 Web 版或同步服务配置。Wayland 壁纸模式、遥控窗等更深机制去 docs/technical.md 里挖。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
