Folia 全屏歌词播放器完整指南15 种歌词动画与多音源播放配置教程【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-majorFolia 是一个以全屏歌词动画为核心的开源音乐播放器歌词不是角落里的滚动字幕而是占据整块屏幕的主角。它支持网易云、酷狗、QQ 音乐、Navidrome自建音乐服务器在线音源与本地文件夹曲库桌面端与 Web 端通用对任意歌曲按一次 H界面即退场只剩按节奏呼吸的歌词动画。Folia 支持哪些音乐源Folia 的音源分两类覆盖在线与本地场景Web 版在线音源网易云音乐、酷狗、QQ 音乐、Navidrome。在首页搜索框输入歌名、歌手或专辑即可搜索并播放封面与歌词自动加载。桌面端额外音源波点音乐、YouTube Music、Spotify、汽水音乐。本地音乐库导入文件夹后直接播放索引保存在本机不上传音频内容。外部播放器接入通过本机 Now Playing 服务一个把系统媒体信息广播出去的轻量服务接入其他播放器的歌曲、时间轴与歌词用 Folia 只渲染舞台视图与全屏歌词。在线匹配与歌词补全按网易云 → QQ 音乐 → 酷狗顺序回退某个来源没有候选时自动换下一个。我该下载哪个版本桌面端安装步骤桌面版基于 Electron用 Web 技术打包桌面应用的框架内置前后端运行环境装完即用平台获取方式Windows / macOSReleases 页面的安装包Apple Silicon 有专属版本Debian / Ubuntu / Linux Mint.deb包Fedora / RHEL / openSUSE.rpm包Arch / ManjaroAUR 安装folia-major-bin其他 Linux 发行版解压tar.gz直接运行folia-major手机 / 平板部署 Web 版后以 PWA 形式添加到主屏幕不想装桌面端、只在浏览器里用的话走后文的 Web 部署。如何播放第一首歌首次启动会有一页欢迎引导扫一眼即可。日常操作其实只有两步在首页搜索框输入歌名、歌手或专辑名点击搜索结果即开始播放封面和歌词自动加载点播放区的把歌加入队列。一个省掉鼠标的小技巧在任何歌曲列表里直接敲键盘就能即时过滤当前内容不必先点进搜索框。如何让歌词接管整个屏幕全屏歌词快捷键一览这是 Folia 的主场。播放歌曲后按H播放控件全部隐藏屏幕只剩歌词动画再按一次恢复。配合F11铺满窗口所有动画都是响应式布局自动适配尺寸无需额外设置。快捷键功能Space播放 / 暂停←/→快退 / 快进 5 秒Ctrl →/Ctrl ←macOS 为Cmd下一首 / 上一首S打开命令面板万能入口Ctrl P打开播放队列P展开 / 收起右侧面板切换在线 / 内嵌 / 本地歌词Tab切换右侧面板选项卡H隐藏播放器控件只剩歌词F11全屏换风格不用翻文档设置 → 视觉 里挑主题每个主题下面都有独立调参面板动画节奏、字幕、背景分开控制。拿不准就去「主题公园」逛一圈——所有主题的真实动画都会跑起来一边听一边对比。内置歌词动画有哪些主题清单内建歌词动画共 15 种代码中的模式清单为唯一权威风格差异很大浮名 / 流光逐字流光的经典形态歌词像光一样从暗场浮出群唱歌词以群聊对话呈现带头像和表情适合合唱与说唱镜台3D 场景歌词悬浮在立体空间中时计时钟机械风齿轮与摆锤驱动绘光舞台光式演出体积光束、烟雾与浮尘花火日式歌词 PV色块字配烟花倾诉、心象、云阶、凝彩、商籁从拼贴排版到舞台光束各不相同其余还有经典、静止等模式动画与背景层可以分开搭配每个主题都能单独调参参数会随设置一起导出、同步。本地音乐库有哪些能力导入与歌词匹配进首页本地音乐区域点导入文件夹选定目录等待后台扫描专辑封面与内嵌歌词会一并读出。几个关键细节支持 MP3、FLAC、M4A、WAV、OGG、Opus、AAC不支持 CUE 分轨整轨文件按一首歌导入同目录同名.lrc、.vtt、.ttml、.qrc、.yrc、.krc歌词文件自动识别兼容 LDDC 的增强型逐字歌词目录下的.foliaignore按.gitignore语法排除文件cover.png/cover.jpg/cover.jpeg可作为整夹封面优先于内嵌封面缺失的歌词与封面可通过在线源批量自动匹配匹配不准可手动选候选、恢复本地信息或合并、拆分艺术家与专辑实体支持导入.m3u/.m3u8歌单Folia 歌单可导出为.m3u8删除曲库只改本地索引不动磁盘文件重扫规则、实体整理、权限恢复与故障排查的完整说明见 本地音乐库管理文档。如何部署到自己的服务器Web 部署与源码构建一键部署Vercel 与 Cloudflare 均支持一键部署 Web 版。部署后 QQ 音乐无需再单独部署 API 实例把VITE_QQ_API_BASE填成/api/qq服务端密钥QQ_SESSION_SECRET不加VITE_前缀配好即可走扫码登录播放前需先登录。Docker 全栈自托管仓库deploy/docker/提供完整 Web 堆栈网关 Folia API 网易云/酷狗/QQ 接口 Sync Server要求 Docker Engine 24 与 Compose v2对外只暴露 Web默认 18080与 Sync Server默认 13000两个端口详见 Docker Compose 全栈部署配置docker compose up -d --wait从源码运行需要 Node.js ≥ 24装依赖后启动开发服务器git clone https://gitcode.com/GitHub_Trending/fo/folia-major cd folia-major npm install npm run dev环境变量、Stage API 与桌面端细节见仓库docs/technical.md。进阶玩法AI 主题、模组系统与多设备同步AI 主题生成接入 Google Gemini 或 DeepSeek 等 OpenAI 兼容接口后按当前歌曲的情绪与歌词内容直接产出专属背景与配色生成结果存进主题库同类歌曲可复用。Folium 模组系统实验性仅桌面端在「设置 → 模组 → 模组系统」中开启后可以安装第三方模组添加歌词动画、背景类型、播放页图层、进度条按钮与命令甚至通过 Node 入口调用本地 ffmpeg。模组以可信代码运行启用前都要在原生窗口确认官方认证模组带 Folium 签名。仓库mods/目录有覆盖各类能力的示范模组模组开发指南 讲从第一个模组到提交市场的全流程。跨设备同步多设备用户可以自托管官方sync-serverCloudflare Workers/D1、Docker 或 Node.js SQLite 三种方式同步外观设置与 AI 主题库在「设置 → 连接与集成」填入服务端地址与SYNC_TOKEN即启用。下一步建议装好后先放一首带逐字歌词的歌按 H 感受全屏动画然后去「主题公园」逐个试听主题最后给本地曲库跑一次批量自动匹配。想深挖动画实现可以从src/components/visualizer/的registry.tsx与definition.ts入手。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
