> For the complete documentation index, see [llms.txt](https://docs.timeinpixels.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.timeinpixels.com/nobe-omniscope/outputs/sdi-output/hdr-pass-through-to-an-hdmi-display.md).

# HDR pass-through to an HDMI display

Put OmniScope between an HDR source such as an Apple TV and an HDR TV, keep the TV in HDR mode, and watch the scopes live.

{% hint style="warning" %}
**BETA** - HDR signaling on DeckLink output is available in beta releases (1.11.65 and later). Install the beta version from the downloads page to access it.
{% endhint %}

This setup places OmniScope in the signal path between a consumer HDR source and an HDR television:

**Apple TV 4K → DeckLink HDMI input → OmniScope → DeckLink HDMI output → HDR TV**

You see the picture on the TV as you normally would, while OmniScope shows the waveform, vectorscope, CIE chart and signal metadata of what the source actually sends. It works for checking how streaming boxes, game consoles and media players handle HDR, for comparing a TV's HDR rendering against the scopes, and for HDR demos and training without a grading suite.

## How it works

An HDR picture and an SDR picture can use exactly the same pixel values. What tells the TV to switch into HDR is a small block of **HDR metadata** sent with the video: the transfer function (PQ or HLG), the Rec. 2020 color space, and mastering display information. If the metadata is missing, the TV shows a PQ picture as if it were SDR, and the image looks flat and less saturated.

When the DeckLink output is set to **Source pass-through**, OmniScope:

1. Reads the dynamic range the source reports on the DeckLink input (shown in **Input Settings → Signal Metadata**).
2. Passes the picture through unchanged.
3. Tags every output frame to match the source. PQ and HLG sources are sent as HDR with Rec. 2020 color, so the TV switches into HDR mode. SDR sources are sent as SDR, so the TV switches back.

It follows the source automatically. If the Apple TV changes between SDR and HDR, for example when it uses **Match Dynamic Range**, the TV follows within a moment.

{% hint style="info" %}
OmniScope sends standard HDR10 mastering values (1000-nit mastering display, MaxCLL 1000, MaxFALL 50) with PQ sources. The source's own mastering metadata is not forwarded, so a TV that adapts its tone mapping to that information may render bright highlights slightly differently than with a direct connection.
{% endhint %}

## What you need

* A DeckLink card with **HDMI input and HDMI output**, for example a DeckLink 8K Pro G2 or a DeckLink 4K Extreme 12G. UltraStudio devices with HDMI connectors work the same way.
* OmniScope **1.11.65 beta** or later.
* An HDR source. This guide uses an **Apple TV 4K**.
* An HDR-capable TV or monitor, with HDMI cables rated for the resolution and frame rate you use.

## Setup

### 1. Connect the hardware

* Apple TV HDMI out → DeckLink **HDMI input**
* DeckLink **HDMI output** → TV HDMI input

If your card has configurable connectors, check in Blackmagic **Desktop Video Setup** that the HDMI connectors are set as one input and one output.

### 2. Check the DeckLink driver setting

In **Preferences → Sources → BlackMagic**, leave **DeckLink SDK version** at **12** (the default) or set it to **14.14**. HDR signaling is not available with the legacy **10.10** option. Restart OmniScope after changing this setting.

### 3. Set up the Apple TV

On the Apple TV, open **Settings → Video and Audio**:

* **Format**: choose an HDR format, for example **4K HDR 60Hz**. If the TV is not offered, pick it from **Other Formats**. For a lighter load on the computer, **1080p HDR** works too.
* **Match Content → Match Dynamic Range**: turn this on if you want the Apple TV to switch between SDR and HDR depending on what is playing. OmniScope and the TV follow each switch.

### 4. Connect the input in OmniScope

Connect the DeckLink HDMI input as a source. Open **Input Settings → Signal Metadata** and check that the **Dynamic range / EOTF** shows **PQ** (or **HLG**) while the Apple TV is in an HDR format. If it shows SDR, the Apple TV is not sending HDR. Check its **Format** setting first.

### 5. Enable the DeckLink output

Open **Video Out Settings**, select the DeckLink HDMI output, and set:

| Setting                  | Value                                                                     |
| ------------------------ | ------------------------------------------------------------------------- |
| **Output Mode**          | **Source pass-through**                                                   |
| **Signal quality**       | **10-bit** recommended. HDR at 8 bits shows visible banding in gradients. |
| **Apply input settings** | Off, for a clean, unmodified picture                                      |
| **Enable audio**         | On, to pass the Apple TV's audio through to the TV                        |

Click **Enable**. The TV should show its HDR indicator (often an "HDR" or "HDR10" badge, or a picture mode change), and its colors should match the OmniScope viewer.

{% hint style="info" %}
**All scopes** mode always outputs SDR, because it shows the OmniScope interface rather than the source picture.
{% endhint %}

### 6. Listen on the computer (optional)

To hear the source on the computer instead of, or as well as, the TV, enable **Input Settings → Audio → Monitor audio**. Audio plays through the system's default output device. With **Monitor audio** enabled, the **Audio Meter** also gets solo buttons to audition individual channels.

## Verifying the result

| Check                         | Expected                                                                                                                                     |
| ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| Apple TV set to an HDR format | Signal Metadata shows PQ, the TV switches into HDR mode, colors match the viewer                                                             |
| Apple TV set to an SDR format | Signal Metadata shows SDR, the TV switches back to SDR                                                                                       |
| Waveform in HDR               | Set the [Waveform](https://docs.timeinpixels.com/nobe-omniscope/scopes/waveform.md) scale to **PQ ST 2084** to read highlight levels in nits |

## Troubleshooting

**The TV stays in SDR and colors look washed out.** Check that you are running 1.11.65 beta or later, that the output is in **Source pass-through** mode, and that **DeckLink SDK version** is not set to **10.10**. Then confirm that **Signal Metadata** shows PQ or HLG on the input.

**Signal Metadata shows SDR although the Apple TV is set to HDR.** Check the Apple TV's **Format** again. With **Match Dynamic Range** on, the Apple TV only sends HDR while HDR content is playing; its home screen is SDR.

**Black picture or "content not available" in some apps.** Capture cards cannot receive HDCP copy-protected video. Apps that require HDCP may refuse to play, or show a black picture, when connected through a DeckLink card. Unprotected content, such as the Apple TV home screen and screensavers, still passes through.

**The audio drifts out of sync over time at 23.976, 29.97 or 59.94 fps.** Update to 1.11.64 or later, which fixes audio pass-through timing at fractional frame rates.
