Folia 安装与部署实战让全屏歌词动画跑在你的电脑和 NAS 上【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-majorFolia 是一个把歌词渲染成全屏动画的播放器音源覆盖网易云、QQ 音乐、酷狗、Navidrome 与本地音乐库。这里走桌面版与 Docker 自托管两条安装路线装完点开任意一首歌歌词动画就能铺满整块屏幕。 先选路线30 秒对号入座只看你在哪听歌人在电脑前要窗口里看全屏歌词动画 → 选Folia 桌面版Electron 应用装上就能跑音乐已存在 NAS 的 Navidrome 里想在手机浏览器打开 → 选Web 自托管版Node.js DockerPWA 可加到手机桌面没想清楚就先走桌面路线不用服务器、不碰网络配置装完即用门槛最低。 最低门槛路线桌面版安装步骤先说安装包从哪拿。README.md 的「快速下载」一节给了两个渠道网盘夸克 / 百度国内网络下载快但只有 Windows 与 M 系芯片 Mac 的正式版Releases全平台便携包Intel Mac 和 Linux 只能走这里。默认建议Windows 与 Apple silicon 用户取网盘链接图的就是快其余平台直奔 Releases。另外下载前核对一下版本号——网盘镜像可能落后于最新发布发现落后就直接取 Releases 的最新包。通用步骤按系统取文件Windows 选.exeApple silicon 选.dmg双击安装即可。Intel Mac 与 Linux 去 Releases 下载对应平台的便携包Linux 取linux-x64.tar.gz。解压或安装完成后双击应用图标启动。Arch 用户AUR 一条命令装好yay或paru后执行yay -S folia-major-bin助手会自动带上alsa-lib、gtk3、libxss、nss依赖把程序放到/opt/folia-major。构建脚本在 packaging/aur/包的做法是从 Releases 拉folia-major-版本-linux-x64.tar.gz后本地打包。如果你的网络连 Releases 很慢构建会卡在下载环节——别等直接走下面便携包路线自己盯着下载进度更踏实。Folia Linux 安装便携包手动部署Debian、Ubuntu 等发行版四步配好「解压 桌面项」解压linux-x64.tar.gz到固定目录例如~/Apps/Folia/。目录可以自选但要固定下来临时目录不放。把包内resources/linux/folia-major.desktop复制到~/.local/share/applications/。编辑复制出的文件替换两处占位符__APP_PATH__填可执行文件绝对路径__ICON_PATH__填图标绝对路径。Exec/home/yourname/Apps/Folia/folia-major Icon/home/yourname/Apps/Folia/resources/linux/icon.png在应用菜单里找到folia-major点开桌面项即配置完成。占位符细节与示例见 packaging/linux/README-LINUX.txt路径对一遍不会错。 自托管路线Docker 部署 Web 版想让手机浏览器随时打开 Folia就部署自托管 Web 版。不需要源码只依赖 deploy/docker/ 下的两个文件compose.yaml与.env模板.env.example。新建空目录把上面两个文件放进去。执行openssl rand -hex 32生成随机串填入.env的SYNC_TOKEN。同步服务认这一项留空起不来别省。执行docker compose up -d拉起全部服务。浏览器打开http://你的地址:18080Folia Web 版即开即用。已有 Navidrome 的用户把NAVIDROME_URL、NAVIDROME_USERNAME、NAVIDROME_PASSWORD三项填进.env新开的浏览器会自动登录挂上音源免去逐台设备登录。变量全表与端口分配见 deploy/docker/README.md。✅ 安装后自查清单桌面版与 Web 版验证动作一致逐项打勾音源就绪应用内登录网易云 / QQ / 酷狗任一平台或者不登账号向本地音乐库导入一个音频目录二者占其一全屏歌词渲染播放任意歌曲确认歌词以全屏动画形式呈现主题还能切换多套同名歌词识别同目录下的.lrc/.vtt歌词文件被自动加载自动补全本地歌曲自动取回在线歌词与封面两者都到位即装对了踩坑速查Linux 启动后黑屏、模糊或透明度异常→ GPU 路径问题 → 用FOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-major启动仍不稳定再切FOLIA_LINUX_GRAPHICS_MODEsoftware。该变量只改 Linux 桌面启动参数不碰 Web 与同步服务配置。下载到的安装包版本偏旧→ 网盘镜像同步滞后 → 下载前在 README 里核对最新版本号落后就直接取 Releases。启动后怪问题图标缺失、无法启动等→ 可执行文件与resources/目录被拆到不同位置 → 二者必须留在同一便携包目录内不要单独挪动。壁纸模式、遥控窗等更深机制去 docs/technical.md 里继续挖。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考