本地歌曲变身全屏歌词动画播放器【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major你有一堆本地 FLAC打开歌词却只有一段没有画面感的纯文本Foliafolia-major是一个全屏歌词动画播放器播放本地与多平台在线音乐自动匹配歌词把当前行歌词渲染成全屏动画主题。不用改任何配置从启动到看到全屏歌词只需 3 步。速览平台、音源与产出物项目内容运行平台Windows / macOS / Linux 桌面端ElectronNode.js Web 版可部署 Vercel / Cloudflare技术栈React 19 Vite 8 Electron 43 TypeScript源码运行要求 Node.js ≥ 24输入来源本地 7 种格式 MP3 / FLAC / M4A / WAV / OGG / Opus / AAC在线网易云、酷狗、QQ 音乐、Navidrome桌面端另有波点、YouTube Music、Spotify、汽水音乐输出产物全屏歌词动画播放、桌面壁纸模式、逐行 / 逐字歌词呈现版本与协议v0.7.23AGPL-3.0典型用户本地曲库整理者、桌面歌词壁纸用户、想自部署在线音乐站的人全屏歌词动画预览当前行歌词居中显示底部为进度条与曲目信息先对号入座这些它能做这些它不碰适合的场景本地曲库播放递归扫描音乐文件夹读取元数据、内嵌歌词与封面只在本机建立索引不上传音频内容。在线多平台搜索Web 版含网易云、酷狗、QQ 音乐、Navidrome 四平台桌面版再多个 4 家。桌面歌词壁纸三平台均可把窗口沉到桌面最底层常驻边干活边看歌词。主题跨设备同步配套 sync-server 可同步外观设置与 AI 主题库适合多设备用户。明确做不了的事CUE 分轨不支持整轨专辑文件会按 1 首歌导入需先用 foobar2000 或ffmpeg切分。QQ 音乐必须登录才能播serverless 部署形态下扫码登录是播放前置条件。模组系统仅桌面端可用Web 版没有且默认关闭。它不是下载器只做流式播放不会帮你把 MP3 存到硬盘。核心任务实操导入本地音乐并播放全屏歌词动画选启动方式安装包、AUR 或源码运行桌面版内置前后端运行环境从项目 Releases 页取 Windows / macOS / Linux 安装包即可。Arch Linux 直接yay -S folia-major-bin。想跑源码先备好 Node.js 24git clone https://gitcode.com/GitHub_Trending/fo/folia-major后依次执行npm install与npm run dev:electron。Web 版走 Vercel 一键部署部署完在项目设置补齐环境变量。导入音乐文件夹一键索引本地曲库打开 Folia在首页本地音乐区域点导入文件夹选中你的音乐目录。它会递归扫描子目录后台逐首读取标题、艺术家、专辑、时长、ReplayGain、内嵌歌词与封面元数据缺失时会尝试从文件名提取。三件事顺手记下同目录歌词.lrc、.vtt、.ttml、.qrc、.yrc、.krc六种自动加载track.lrc与track.mp3.lrc两种命名都认翻译歌词用track.t.lrc。文件夹封面目录里放cover.png/cover.jpg/cover.jpeg优先级高于内嵌封面。排除规则放一份.foliaignore语法同.gitignore可排除缓存目录与临时音频重新导入即生效。扫描完成后海报墙会出现集合卡片。本地歌曲缺在线歌词和封面时Folia 按网易云 → QQ → 酷狗的顺序自动回退匹配结果不准时去歌曲详情里手动选候选。Web 版导入文件夹依赖浏览器的 File System Access API不支持的浏览器请改用桌面端。本地库主页点Import Folder开始扫描Refresh执行增量重扫播放一首歌核对歌词、封面与动画点开任意一首开始播放当前行歌词立即进入全屏动画。内置浮名、流光、心象、云阶、群唱、倾诉、镜台、时计 8 套主题排版氛围与可调参数各不相同并自动适配窗口尺寸。右侧面板的本地选项卡能在本地、内嵌、在线三种歌词间切换方便核对匹配结果。接了 AI 服务后还能让 Folia 依据歌词与情绪为这首歌生成沉浸式背景与视觉参数。全屏歌词核对当前行歌词高亮显示其余歌词在背景中流动底部为播放进度加一步切到在线音源搜索本地曲库之外切到 Playlists / Radio / Albums 页签直接搜索播放后封面与歌词自动加载各音源的账号与登录态在连接与集成页统一管理。在线音源主页右上角搜索框下方为歌单、电台与专辑页签进阶能力壁纸、模组与跨设备同步把 Folia 变成桌面歌词壁纸壁纸模式「设置 → 桌面」或托盘菜单一键开启窗口沉到桌面最底层此模式下键盘输入不可达控制走托盘与遥控窗多显示器可指定壁纸落在哪块屏。实现细节三平台各走一条路径Windows 挂 WorkerW 层、Linux 走 layer-shell、macOS 原地沉层完整机制见 docs/wallpaper-mode.md。给播放页装模组模组系统Folium桌面端实验功能「设置 → 模组」先打开模组系统开关每个模组启用前都要在原生窗口确认一次。认证分级与示例市场模组分官方认证 / 先行测试 / 未验证三档仓库 mods/ 目录含歌词动画、进度条按钮、播放页图层、透明视频导出等官方示例照着改最快。模组系统示例第三方歌词动画模组渲染当前行歌词与等高线背景主题与设置跨设备同步sync-server官方同步服务端Cloudflare Workers / D1推荐、Docker、Node.js SQLite 三种部署任选只同步外观设置与 AI 主题库。接入配置「设置 → 连接与集成」填服务端地址与SYNC_TOKENToken 长度 8~32 位服务端对短 Token 拒绝启动。自部署在线版Serverless 形态Vercel / Cloudflare 上把VITE_QQ_API_BASE填成/api/qq再配一个不加VITE_前缀的QQ_SESSION_SECRETQQ 音乐就不用额外部署 API 实例。全栈自托管Compose 部署入口在 deploy/docker本地音乐目录访问依赖可信 HTTPS 安全上下文NAS 场景需配好反向代理与证书。速查表回头要查的都在这项值克隆源码git clone https://gitcode.com/GitHub_Trending/fo/folia-major源码运行npm install后npm run dev:electronNode ≥ 24Linux 安装yay -S folia-major-binArch / Manjaro其他发行版取 .deb / .rpm / tar.gz支持音频MP3 / FLAC / M4A / WAV / OGG / Opus / AAC 共 7 种同目录歌词.lrc.vtt.ttml.qrc.yrc.krc按此顺序优先歌词匹配回退网易云 → QQ → 酷狗回环歌词接口http://127.0.0.1:32109/v1/lyric仅本机、无鉴权offset字段带毫秒偏移同步 TokenSYNC_TOKEN8~32 位必填DASHBOARD_TOKEN16 位以上选填QQ 音乐serverlessVITE_QQ_API_BASE/api/qqQQ_SESSION_SECRET扫码登录后可播更新通道latest/beta/alpha三通道Realeco / Limo / Cielo拿到第一首全屏歌词后顺手试试「桌面」页的壁纸模式再把外观设置通过 sync-server 同步到另一台设备 【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
