10 分钟把 Folia 歌词动画播放器装进手机主屏幕

10 分钟把 Folia 歌词动画播放器装进手机主屏幕【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-majorFolia 没有官方手机 App但它的 Web 版原生支持 PWA你完全能自己把这台歌词动画播放器搬进手机主屏幕从点下启动命令到图标出现在桌面上快的话 10 分钟就能搞定。装好之后登录态留在手机浏览器里弱网秒开点开就是全屏听歌。能不能装在手机上先看这张表能力手机 PWA 上的表现原因在线搜索与播放网易云 / QQ / 酷狗✅ 支持走浏览器登录登录态存在手机本地全屏歌词动画主题✅ 支持排版跟随窗口尺寸响应式重排竖屏自动调整Navidrome 私有曲库✅ 支持纯 HTTP 接口调用手机无压力AI 自动主题配色✅ 支持需要部署时配好 AI 密钥导入手机里的本地音乐文件❌ 不支持依赖 File System Access API手机浏览器没有这个接口一句话总结把 Folia PWA 当歌词动画播放器 在线/Navidrome 曲库来用手机上是完整体验唯一缺口是本地文件导入。三条部署路线走哪条路线谁适合要先有什么大概多久一键托管到 Vercel / Cloudflare没有服务器、只想先试试一个平台账号HTTPS 免费自带5~10 分钟Docker 全栈自部署有 NAS 或一台 Linux 服务器Docker 24愿意配反代和证书15~30 分钟克隆仓库自己部署想逐行改前端、魔改主题Node.js 24会配环境变量30 分钟起推荐 Docker 自部署。一键托管虽然省事但音源 API、AI 密钥、QQ 登录态都寄存在第三方平台上自部署能把这些全部留在自己手里NAS 用户还能把曲库和 Folia 放在同一台机器上局域网内秒开。克隆部署留给想改代码的人按 docs/technical.md 的本地开发一节补好VITE_NETEASE_API_BASE等变量用 vercel dev 起服务即可。先配好 Docker 全栈再装主屏幕服务器侧起 Folia 容器在 NAS 或任意 Linux 服务器上新建一个空目录拉取 deploy/docker/compose.yaml 和环境变量模板.env.example放进这个目录用 openssl 随机生成一个十六进制串填进.env的SYNC_TOKENAI 相关配置留空不影响播放执行docker compose up -d浏览器打开http://NAS-IP:18080能看到页面就成了完整字段说明在 deploy/docker/README.mdQQ 音乐的登录态配置见 deploy/docker/qq-api/README.md。这个栈默认只发布 Web 网关18080和 Sync Server13000两个端口网易云、QQ 音乐等内部服务都走 gateway不直接对外。给手机装 PWA 之前先解决 HTTPSPWA 的安装和离线缓存依赖 Service Worker它只在 HTTPS 安全上下文里可靠工作HTTP 下手机经常直接找不到安装入口。所以 NAS 场景要用反代Caddy / Nginx 等把域名加可信证书转出来指向 18080 端口。容易忽略的一点HTTP 和 HTTPS 是两个独立的源证书换完之后登录态、设置、曲库索引都不会自动迁移需要重新登录一次。反代侧要传全X-Forwarded-Proto、X-Forwarded-For等头信息细节见 deploy/docker/README.md 的HTTPS 与浏览器安全上下文一节。安卓Chrome 里的安装入口用 Chrome 打开你的 Folia 地址点右上角 ⋮ 菜单选添加到主屏幕确认名称显示为 Folia点添加iPhoneSafari 分享菜单用 Safari 打开地址点底部 ⬆️ 分享按钮上滑找到添加到主屏幕核对名称和图标点添加装完主屏幕出现 Folia 图标点开是独立全屏窗口没有地址栏核心资源走本地缓存弱网下也是秒开。装完后手机里看到什么Folia 的招牌是全屏歌词动画主题每个主题有独立排版且会按窗口尺寸重排竖着拿手机不会出乱。挑三个最有记忆点的pendolo齿轮与星空轨道机械齿轮加星空轨道的深色画面主歌词横排在屏幕一侧副歌进入时高亮逐字亮起。cappella对话气泡式群唱歌词被排成一串对话气泡左右交替推进像几个人在接唱竖屏窄画面下尤其好读。lumi深色流光深色底加流动光效OLED 屏上黑位纯净夜里听歌不晃眼。主题随时可以在设置里的主题速编入口切换部署时配了 AI 密钥的话配色还能按歌曲情绪自动生成。再进一步Navidrome 曲库听自己的歌想听自己存的音乐把文件放 NAS手机通过 Folia 远程访问既不占手机空间也省流量在 NAS 上用 Docker 部署 Navidrome挂载你的音乐目录在 Folia 的.env里填NAVIDROME_URL、NAVIDROME_USERNAME、NAVIDROME_PASSWORD三项执行docker compose up -d --force-recreate backend让新配置生效之后任何新打开的浏览器都会自动登录这个 Navidrome 并启用它手机、电视、电脑不用再各登录一次。接上之后首页就是这样的私有曲库视图容易忽略的一点NAVIDROME_URL必须填各设备都能访问到的地址不能写 Docker 内部主机名Folia 走 HTTPS 时它也得是 HTTPS否则浏览器会拦截混合内容。另外局域网里能打开 Folia 页面的人都能读到这组凭据建议单独建一个 Navidrome 账号给 Folia 用。出问题先查这四个手机上找不到添加到主屏幕入口多半是地址栏不是 HTTPS。Service Worker 只在安全上下文可靠注册HTTP 下安装入口经常直接消失。确认反代与可信证书都到位安卓用 Chrome、iOS 用 Safari再重新加载一次页面。服务器更新了手机还是旧版本Service Worker 走 autoUpdate 策略更新要等下次冷启动才生效。完全关掉 App 重进等一次长时间不更新就清除一次站点数据再重新添加。手机上能不能导入本地音乐不能。目录导入依赖 File System Access API只有桌面 Chromium 系浏览器提供手机浏览器没有这个接口本地曲库管理的边界见 docs/local-library-management.md。想在手机上听自己的歌走上文的 Navidrome 路线。配好反代 HTTPS 后封面缓存和输出设备选择恢复了会恢复。OPFS 封面缓存、音频设备枚举都要求安全上下文HTTP 下这些能力全部降级。证书换完后记得重新登录因为 HTTP 与 HTTPS 是两个独立源登录态和设置不会自动迁移。速查照着这张表走一遍步骤操作耗时1Docker 起 Folia 全栈约 10 分钟2反代加可信证书转成 HTTPS约 10 分钟3手机菜单/分享 → 添加到主屏幕约 2 分钟4点图标全屏听歌看歌词动画长期从起容器到图标出现在主屏幕十几分钟走完。之后这台随身歌词动画播放器里在线搜索、私有曲库、AI 配色全都在同一个全屏窗口里。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考