欢迎使用MoeKoeMusic-TaskbarLyrics-plugin ——MoeKoeMusic 的Windows任务栏歌词插件

[Yngu196]

MoeKoeMusic 任务栏歌词插件 — 在 Windows 任务栏上显示逐字高亮歌词，让你的音乐体验不再被窗口遮挡。

这是什么？

MoeKoeMusic 任务栏歌词插件 是一个 Windows 原生应用，通过 Direct2D 渲染将歌词直接呈现在任务栏上。它作为 MoeKoeMusic 的插件运行，不依赖任何第三方歌词源，直接读取播放器的实时歌词数据。

主要特性

• 卡拉OK 逐字高亮 — 基于 KRC 字符级时间轴，歌词随播放进度逐字着色
• 双语歌词支持 — 自动识别 LRC 翻译标签，支持「仅原文 / 原文+翻译 / 仅翻译」三种模式
• 任务栏自适应 — 自动检测任务栏位置（底部/顶部/左/右），跟随任务栏尺寸变化
• 可拖动定位 — 解锁后可自由拖动歌词位置，松手自动吸附到任务栏空位
• 播放控制按钮 — 歌词区域内置上一曲/播放暂停/下一曲按钮
• D2D 原生设置界面 — 自绘高 DPI 设置窗口，可调整字体、颜色、透明度等
• 系统托盘驻留 — 最小化到托盘运行，右键菜单快速访问常用功能
• WebSocket + HTTP 双通道 — 主通道 WebSocket 实时推送，HTTP 兜底保障连通性
• 频谱可视化 — 可选显示音频频谱条
• 全屏自动隐藏 — 检测到全屏应用时自动隐藏歌词窗口

系统要求

• Windows 10 21H2+ / Windows 11
• MoeKoeMusic 1.6.6+
• 64 位系统

快速开始

1. 从 Releases 下载最新版 zip 包
2. 在 MoeKoeMusic 中通过「安装插件从 zip」导入
3. 播放音乐，歌词自动出现在任务栏

本项目已上架 MoeKoeMusic 的插件市场，你也可以在 MoeKoeMusic 的插件市场进行安装

技术栈

层 技术 渲染 Direct2D + DirectWrite 窗口 Win32 分层窗口 (WS_EX_LAYERED) 通信 WebSocket / HTTP (本地 Token 鉴权) 构建 CMake + vcpkg + MSVC 14.44 测试 Catch2

参与贡献

欢迎各种形式的参与：

• 反馈问题 → 提交 Issue
• 功能建议 → 功能请求
• 代码贡献 → Fork → 修改 → PR
• 交流讨论 → Discussions

项目使用 GPL-3.0 协议开源，期待你的参与！

[FlyGongZi]

WebSocket 状态
重连中...

好像不太行

[Yngu196]

MoeKoeMusic的API模式开启了吗？
具体情况是什么呢？

安装并授权插件后一般需要重启MoeKoeMusic一到两次，因为插件开启MoeKoeMusic的api模式需要重启才能生效，不重启的话api模式无法开启，api模式不开启的话就会出现websocket重连中