实时歌词同步
通过 Windows SMTC 抓取系统正在播放的歌曲，自动匹配网易云公开歌词，逐行滚屏。
概览
让主屏之外的那块小屏，同步唱出每一句歌词
ESP32歌词副屏开源硬件
核心特性
它做对了什么
双轨进度校准
SMTC 时间轴为主、桌面歌词 OCR 校准为辅，解决播放器进度不准导致的歌词漂移。
高清点阵显示
内置 GB2312 中文字库，16×16 点阵清晰可读，支持滚屏与居中排版。
纯静态固件
基于 ESP-IDF 的轻量固件，开机自动联网配对，断线自动重连。
完全开源
硬件设计、固件与上位机全部开源，可自行打样、复刻与二次开发。
规格参数
技术规格
主控ESP32-C3 / ESP32-S3
显示单色点阵副屏
通信USB 串口 / Wi-Fi
上位机Windows 10/11（.NET 8）
字库GB2312 中文 + ASCII
协议自定义轻量帧协议（歌词行 / 元数据 / 进度）
这是什么
歌词副屏是一块放在主屏之外的桌面小屏。它会在你听歌时，实时同步显示当前歌词， 让你不必切换窗口，也能看到正在播放的每一句。
整机由一块 ESP32 主控板、一块单色点阵副屏和一套 Windows 上位机组成： 上位机负责抓歌、匹配歌词并推送，副屏负责渲染与显示。
工作流程
- 抓歌：上位机通过 Windows SMTC（系统媒体传输控件）读取当前播放的歌曲信息。
- 匹配歌词：按歌名与歌手从网易云公开歌词接口拉取时间轴歌词。
- 进度对齐：以 SMTC 时间轴为主，必要时用桌面歌词 OCR 进行校准。
- 推送：通过串口协议把歌词行、元数据与进度帧发送给副屏。
- 渲染：副屏使用内置中文字库逐行滚动显示。
为什么做它
市面上不少“歌词屏”要么闭源、要么只能显示英文、要么进度经常对不上。 歌词副屏希望解决的正是这些细节：中文字库、进度校准、完全开源。
快速开始
- 硬件：按开源仓库中的原理图打样，或直接使用兼容开发板。
- 固件：见 下载中心 或仓库
releases。 - 上位机：Windows 10/11 直接运行，插入副屏后自动识别串口。
详细的接线、烧录与配对步骤见 文档。