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

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

- 类型：案例
- 目标：应用 · 协议
- 类别：独立重建案例
- 关联：独立重建项目
- 来源复核于：2026-10-18
- 收录于：2026-10-19
- 原始资源：<https://github.com/talkaboutdesign/elgato-hdr>
- 一手来源：<https://github.com/talkaboutdesign/elgato-hdr/blob/7799d3c53520bcc3dd049211244bfaf49b905cb0/README.md>
- 目录页面：<https://awesomerea.org/zh/resources/elgato-hdr-uvc-capture-case/>
- 记录 JSON：<https://awesomerea.org/resources/elgato-hdr-uvc-capture-case/record.json>
- 英文版：[English](https://awesomerea.org/resources/elgato-hdr-uvc-capture-case/index.md)

## 使用条件与局限

- **前提条件：**构建需要 Xcode Command Line Tools 和 Homebrew 的 libusb：build.sh 会将 C 辅助程序与 libusb 链接、打包该库、编译 Swift 应用并做临时签名，发布版本未经公证。由于卸下 macOS 内核驱动需要 root 权限，辅助程序需要一次管理员授权；应用退出约 20 秒后它会自行退出，并把采集卡交还给 macOS。
- **范围：**审阅版本为 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 采集。
- **范围：**仓库保留了逆向采集卡时使用的 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 协助了这项延迟工作。

## 一手来源

1. <https://github.com/talkaboutdesign/elgato-hdr/blob/7799d3c53520bcc3dd049211244bfaf49b905cb0/README.md>
2. <https://github.com/talkaboutdesign/elgato-hdr/blob/7799d3c53520bcc3dd049211244bfaf49b905cb0/tools/uvc_capture.c>
3. <https://github.com/talkaboutdesign/elgato-hdr/blob/7799d3c53520bcc3dd049211244bfaf49b905cb0/tools/usb_desc_dump.c>
4. <https://github.com/talkaboutdesign/elgato-hdr/blob/7799d3c53520bcc3dd049211244bfaf49b905cb0/tools/modetest.py>
5. <https://github.com/talkaboutdesign/elgato-hdr/blob/7799d3c53520bcc3dd049211244bfaf49b905cb0/build.sh>
6. <https://github.com/talkaboutdesign/elgato-hdr/blob/7799d3c53520bcc3dd049211244bfaf49b905cb0/LICENSE>
7. <https://github.com/talkaboutdesign/elgato-hdr/pull/1>
8. <https://x.com/talkaboutdesign/status/2109795113807630735>

## 同分区更多条目：应用

- [LGwebOS-menubar：LG webOS 电视的原生 macOS 遥控器](https://awesomerea.org/zh/resources/lgwebos-menubar-remote-case/index.md) · 案例
- [Galaxy Buds Client：基于三星耳机协议的非官方管理器](https://awesomerea.org/zh/resources/galaxy-buds-client-protocol-case/index.md) · 案例
- [Wino Mail：重建 Windows 邮件与日历体验](https://awesomerea.org/zh/resources/wino-mail-case/index.md) · 案例
- [ScooterLink：重建 Honda RoadSync 车把按键协议](https://awesomerea.org/zh/resources/scooterlink-honda-roadsync-case/index.md) · 案例
- [iX500 Scan：基于逆向 ScanSnap Wi-Fi 协议的 macOS 客户端](https://awesomerea.org/zh/resources/ix500-scan-scansnap-wifi-case/index.md) · 案例
- [WristBeam：为 Mac 配套应用重建佳明手表协议](https://awesomerea.org/zh/resources/wristbeam-garmin-watch-protocol-case/index.md) · 案例

## 关于此条目

说明已依据一手来源复核。
原创说明采用 MIT 许可；外部项目、论文与素材保留各自的权利和许可。