GetTheNya/HdrBridge
GitHub: GetTheNya/HdrBridge
轻量级 C# 桥接工具，通过逆向 USB-HID 协议让廉价 Ambilight 控制器无缝对接 HyperHDR 生态。
Stars: 0 | Forks: 0
# 🌈 HdrBridge (HB)
  
**连接平价 USB-HID LED 控制器与专业 HyperHDR 生态的缺失桥梁。**
一款轻量级、原生 C# WPF 应用程序，旨在将廉价的专有 USB LED 灯带（SyncLight / PC Screen Sync）桥接至 **[HyperHDR](https://github.com/awawa-dev/HyperHDR)** 的专业开源 Ambilight 生态系统。
## 🔍 硬件兼容性
本软件专为使用 **HID 协议** 的国产 USB Ambilight 套件设计。
* **VID:** `0x1A86` | **PID:** `0xFE07`
* **常见品牌：** Skydimo, SyncLight, Ambilight PC Kit。
* **设备外观：** 带有 **3 个物理按钮** 的小型控制器（静态模式、电源、音乐模式）。
## 📖 开发动因：“源于无奈”
如果您拥有这款硬件，就会明白其中的痛点：官方的“SyncLight”应用资源占用高、延迟大，且通常无法捕获 HDR 内容。
**HdrBridge** 是一个轻量级的原生 C# 替代方案。我们通过逆向工程破解了 USB HID 协议（抓取数据包、破解校验和以及处理远程中断），只为您带来专业级的体验。不再有臃肿软件，只有纯粹的性能。
## ✨ 主要特性
* **🚀 零臃肿：** 基于 .NET 8 构建，专注于极低的 CPU/GPU 开销。
* **🔘 物理遥控同步：** 与其他应用不同，HdrBridge 会监听您的物理遥控器。按下线缆上的“电源”键，应用会自动暂停 HyperHDR 流。
* **🔧 自愈能力：** 强大的 USB 监控 —— 插拔设备，桥接程序即可瞬间恢复。
* **👻 托盘驻留：** 在后台静默运行，支持自启动。
* **🎛️ 硬件特效控制：** 直接从应用触发灯带的内置硬件特效（彩虹、呼吸、静态颜色）。
## 🛠️ 工作原理
1. **HyperHDR** 捕获您的屏幕（DirectX/HDR）并通过 **UDP（端口 19446）** 发送 RGB 数据。
2. **HdrBridge** 拦截 UDP 流，计算专有的 332 字节数据块，并使用必需的校验和对其进行签名。
3. **HID 通信：** 桥接程序向控制器发送原始命令，无需任何国产驱动程序。
## 🚀 安装与设置
1. 从 [最新发布版](../../releases) 下载 `HdrBridge.zip`。
2. 运行 `HdrBridge.exe`（确保已安装 **.NET 8 Desktop Runtime**）。
3. 将您的 **HyperHDR** 输出设置为 `udpraw`，IP `127.0.0.1`，端口 `19446`。
4. 应用程序将自动检测您的 LED 灯带并进行初始化。
5. 享受流畅、专业的 Ambilight 体验。
### ⚙️ HyperHDR 配置详情
在 HyperHDR Web 界面中，按如下方式设置 LED 硬件：
* **Controller Type:** `udpraw`
* **Target IP:** `127.0.0.1`
* **Port:** `19446`
* **重要：** 在 LED 布局设置中调整 *Input Position* 或 *Reverse Direction*，以匹配您物理 LED 灯带的起始位置。
## 🛠️ Node.js 替代方案（参考）
如果您更喜欢极简的 CLI 方法或需要协议的代码参考，我们提供了 `node_strip_test.js`。这是一个精简的脚本，它可以：
* 初始化 USB 设备。
* 在端口 `19446` 上启动 UDP 服务器。
* 直接将 RGB 数据转发到灯带，无 UI 或复杂逻辑。
**运行方法：**
1. 安装 [Node.js](https://nodejs.org/)。
2. 安装 HID 依赖：`npm install node-hid`。
3. 运行脚本：`node node_strip_test.js`。
## 🤝 贡献
如果您发现了新的硬件特效 ID 或想要改进 UI，请随时开启 Issue 或提交 Pull Request！
## 📜 许可证
本项目基于 MIT 许可证授权 - 详情请参阅 [LICENSE](LICENSE) 文件。
*由 [GetTheNya](https://github.com/GetTheNya) 用 ❤️ 开发*
标签：Ambilight, _bias lighting, HDR内容捕捉, HyperHDR, LangChain, LED控制器, .NET 8, Skydimo, SyncLight, USB-HID, Windows桌面应用, WPF, 云资产清单, 低延迟, 协议分析, 实时流媒体, 屏幕同步, 权限提升, 物联网工具, 硬件交互, 硬件桥接, 系统托盘, 自动恢复, 轻量级, 逆向工程