嗷呜点歌机复古 CMD Mod UI

这是为嗷呜点歌机制作的复古 Windows 命令行风格 Mod UI。它用于 OBS、直播姬等直播软件的“浏览器捕捉”，在直播画面中展示当前歌曲、点歌人、待播队列和必要的异常状态。

组件保留官方示例的左右分栏布局：左侧显示当前歌曲，右侧显示待播队列。外观参考经典 Windows 命令行窗口，歌曲封面会像唱片一样缓慢旋转；暂停自动播放时旋转也会暂停。

页面背景透明，没有交互按钮，也不会向点歌机发送控制请求。

安装

在嗷呜点歌机 1.1.6 或更高版本的“外观设置 → Mod UI”中输入：

https://github.com/Enkianssus/AwooMusicBot-Overlay-RetroCMD

也可以从 Releases 下载 awoo-overlay.zip，点击“选择 ZIP”或把 ZIP 拖入安装区域。切换 UI 后，OBS 仍使用点歌机中显示的固定 /overlay/ 地址，不需要重建浏览器来源。

显示内容

• 当前歌曲、歌手与点歌人
• 待播队列及歌曲数量
• WebSocket 或 HTTP 只读连接状态
• 暂停接收点歌、暂停队列播放和播放器断开提醒
• 可在点歌机中实时调整标题栏、终端、文字、强调色、透明度、扫描线、缩放、队列数量和封面旋转

本地预览

直接打开源码时，页面默认读取 127.0.0.1:5556。点歌机安装后的页面会自动使用自身端口。

可用参数：

• maxQueue=3：显示的队列条数，范围 1–30
• port=5556：仅用于直接打开本地源码时覆盖 API 端口

安装到点歌机后，可以在“外观设置”的实时预览旁调整 10 项参数。每一项都能单独恢复默认值，设置会按 UI 独立保存在本地，升级后继续沿用。

开发说明

本主题复用了官方默认 Mod UI 的只读数据适配逻辑，可作为另一种视觉主题的参考：

• ZIP 根目录包含 overlay.json 和其中声明的入口 HTML
• 脚本使用独立 JavaScript 文件，不依赖内联脚本
• 只读取 GET /api/v1/state 和只读 WebSocket /ws
• 外部文本通过 textContent 写入 DOM
• 页面背景保持透明，适合叠加到直播画面

完整协议与安全限制见嗷呜点歌机 Mod UI 文档。

License

MIT