案例

Elgato HDR:为 Elgato 4K X 的 10 位模式提供用户态采集通路

一款原生 macOS 应用,用于获取 Elgato 4K X 采集卡的 10 位 P010 视频模式;项目称苹果内置的摄像头驱动不会向应用开放该模式。一个 root 权限辅助程序卸下该驱动,通过 libusb 直接执行采集卡的 USB 视频类(UVC)串流,为 Metal HDR 预览、HDR10 录制和编辑器提供画面。延迟数据和设备覆盖范围仍为作者报告。

使用条件与局限

  • 审阅版本为 2026-10-13 的最新提交,晚于 1.0.0 版(2026-09-08)。目标设备为 macOS 14 及以上系统上的 Elgato 4K X;README 称仅在 Apple Silicon 上构建和测试,其他提供 P010 UVC 格式的 Elgato 采集卡未经测试。HDR 预览需要支持 HDR/EDR 的显示器。在各个 10 位模式中,4K 受 USB 带宽限制只能以 30 fps 采集。
  • 构建需要 Xcode Command Line Tools 和 Homebrew 的 libusb:build.sh 会将 C 辅助程序与 libusb 链接、打包该库、编译 Swift 应用并做临时签名,发布版本未经公证。由于卸下 macOS 内核驱动需要 root 权限,辅助程序需要一次管理员授权;应用退出约 20 秒后它会自行退出,并把采集卡交还给 macOS。
  • 仓库保留了逆向采集卡时使用的 USB 描述符转储工具,以及遍历全部采集模式的脚本;仓库不含厂商固件或驱动二进制文件。由于 README 称采集卡不会通过 USB 传递信号源的 HDMI HDR 元数据,录制文件写入的是固定的 HDR10 母版元数据。
  • README 及 Game 模式拉取请求报告:在 120 Hz MacBook Pro 上以 1440p60 采集时,Smooth、Game 和 Lowest Latency 三种模式的显示延迟约为 48、22 和 5 毫秒,计时从 USB 传输完成到画面显示,以 macOS 报告为准;采集卡自身的处理时间另计,该 PR 还指出测试用采集卡输出的是静音音频。这些均为作者测量,本目录未复现。
  • MIT 许可覆盖项目代码;打包的 libusb 库和采集内容保留各自条款,项目声明与 Elgato 或 Corsair 无关联。同名 X 账号的帖子称 REA 协助了这项延迟工作,但仓库未提及 REA,因此 REA 的使用未经确认。

关于此条目

类型
案例
类别
独立重建案例
关联
独立重建项目
目标
应用 · 协议

来源复核于

说明已依据一手来源复核;这不代表已运行验证、经过安全审计或确认兼容。

一手来源

  1. README.md GitHub · talkaboutdesign/elgato-hdr · 修订 7799d3c
  2. tools/uvc_capture.c GitHub · talkaboutdesign/elgato-hdr · 修订 7799d3c
  3. tools/usb_desc_dump.c GitHub · talkaboutdesign/elgato-hdr · 修订 7799d3c
  4. tools/modetest.py GitHub · talkaboutdesign/elgato-hdr · 修订 7799d3c
  5. build.sh GitHub · talkaboutdesign/elgato-hdr · 修订 7799d3c
  6. LICENSE GitHub · talkaboutdesign/elgato-hdr · 修订 7799d3c
  7. https://github.com/talkaboutdesign/elgato-hdr/pull/1
  8. https://x.com/talkaboutdesign/status/2109795113807630735