Blackmagic Decklink Target v4
Introduction
The Blackmagic Decklink Target v4 sends the composed scene out through a Blackmagic Decklink card over SDI or HDMI — to a vision mixer, studio monitor, broadcast recorder, IRD / encoder hand-off point, or any other professional piece of kit on the SDI/HDMI side of the production chain. It's the inverse of the BlackMagic DeckLink Capture v3 input: same family of cards, same (card, channel) selection model, same multi-card support — but the data flows the other way.
The v4 generation supersedes the original target, v2, and v3 (all still ship for backwards compatibility but are hidden from the docs); new projects should always use v4. For latency-sensitive plant where a fixed-buffer scheduled-playback model is required (genlock-tight broadcast, RP188 timecode, master-control playout), there's a separate scheduling variant that's not covered here — talk to RealSprint Support if you think you need it.
Multiple Decklink cards on one host
Composer fully supports running multiple Decklink cards in the same host, with as many output targets as the cards collectively expose channels. Each Decklink Target binds to a single (card, channel) pair selected from the dropdowns in the property panel; drop another instance on the scene for each additional channel you need to drive. Composer enumerates every Decklink-recognised channel on the host at startup, regardless of how many physical cards back them.
Practical guidance for multi-card output setups:
- Mind the PCIe budget. Each Decklink card consumes lanes; multi-card hosts on consumer-class CPUs run out of lanes faster than you'd expect, and the motherboard then silently downgrades the GPU's slot from x16 to x8, cutting the bandwidth available for cudaMemcpy frame transfers and showing up as dropped frames under load. See Operations & Tuning → PCIe bandwidth considerations for lane budgets per card and slot-allocation advice.
- Pick a card that gives you channels per slot. A Decklink Quad 2 (4 × 3G-SDI), Quad HDMI Recorder (4 × HDMI 2.0), or Decklink Duo 2 yields multiple channels per single PCIe slot — substantially better lane economics than a stack of single-channel cards.
- Set a capture card as the sync source in the Settings → General tab when running both Decklink inputs and outputs in the same project. Taking the sync from a genlocked input keeps capture and playout on the same render tick.
- Composer Runtime supports the same multi-card setup headlessly — projects move between Desktop and Runtime without changes. For a production playout host with several output cards, the Runtime is typically the right deployment target.
Common use cases
- Program output to a vision mixer — clean program feed from Composer's compositor into the studio's SDI router or vision mixer, alongside camera feeds.
- Studio confidence monitor — a downstream-of-everything hardware-decoder feed for an operator's monitor, showing exactly what's going to air.
- Master-control hand-off — provide a finished mixed feed to a master-control room, IRD, or downstream encoder rack over baseband.
- Recorder feed — drive an SDI recorder for an archive copy of the live program output.
- Multi-language broadcasts — the 8-channel audio mode unlocks the Channel Strip Inspector's MAPPING tab, useful for embedded multi-language audio over SDI to downstream distribution.
- Backup chain — run the SDI output in parallel with RTMP / SRT targets so a network-side outage doesn't take the studio chain off air.
Driving from outside
Every command (Start, Stop) is invokable from the property panel, the HTTP API (/api/invokecommand?targetname=Decklink+Target&command=StartCommand), a Connector, or the Script Engine via ExecuteCommand / ExecuteCommandById. The current device name and runtime statistics are surfaced as readable properties so dashboards and scripts can monitor the output without polling the SDI side directly.
Related components
- BlackMagic DeckLink Capture v3 — the input counterpart. Use it on the same host to receive SDI / HDMI signals; the same multi-card guidance applies.
Blackmagic Decklink Target v4 - Settings
Configuration
Configuration — pick the Decklink output, display mode, and audio channel count.

| Property | Description |
|---|---|
Autostart when application starts |
Whether the target starts automatically as soon as the project loads. [default=false]. When true, the target invokes its start logic immediately on load (equivalent to running StartCommand). Make sure DecklinkOutputChannel and DisplayMode are configured first — otherwise startup will fail and the target will sit idle. |
Output channel |
Which physical Decklink output port to send video and audio to. Selects one of the available Decklink output channels detected on the system. A card may expose multiple channels (e.g. SDI 1, SDI 2, HDMI), and only one target instance can drive each channel at a time. Must be set before StartCommand will run; clearing this disables playback. Locked while playback is starting or running — stop the target before changing it. |
Display mode |
Resolution and frame rate the target negotiates with the Decklink card. Selects the display mode advertised over SDI/HDMI — for example 1080p50, 1080i59.94, or 2160p30. The list contains only the modes that match both the selected DecklinkOutputChannel's capabilities and the current project frame rate. After changing the project frame rate (in Performance and project options), re-lock the frame rate to refresh this dropdown — until the lock is re-engaged it still shows the modes for the previous frame rate. Pick a mode that matches the downstream equipment (switcher, monitor, recorder) to avoid frame-rate conversion or "no signal" errors. Locked while playback is starting or running. |
Audio channels |
(advanced) Number of audio channels to embed alongside the video signal. [default=Two]. Two (stereo) is the standard choice for most workflows. Eight enables 8-channel embedded audio output, used for multi-language broadcasts (each language pair on its own channel pair), surround sound, or split-feed productions. The selected value must be supported by the chosen output channel and respected by downstream equipment. Locked while playback is starting or running. |
Device name |
Friendly name of the Decklink device currently in use (read-only). Reflects the model/identifier reported by the Decklink driver for the selected DecklinkOutputChannel (for example "DeckLink 8K Pro (1)"). Useful from scripts to confirm the right card was picked when more than one Decklink device is installed, or to surface the device label in a status overlay. |
Status
Status — current playback state and the start/stop commands.

| Property | Description |
|---|---|
Playback state |
Current playback state of the target (read-only). Reflects whether the target is Stopped, Starting, Running, Stopping, or Restarting. Driven indirectly by StartCommand / StopCommand, by AutoStart at load time, and by internal restart logic on configuration changes. Scripts should read this to decide whether the SDI/HDMI signal is live; the value also drives the running indicator and the enabled state of the Start/Stop buttons. |
Start |
Begin sending video and audio to the selected Decklink output. Invokable command. Opens the chosen DecklinkOutputChannel at the configured DisplayMode and AudioChannels, locks those settings, and starts streaming the scene to the card. Disabled until a valid output channel is selected. No-op if the target is already starting or running. |
Stop |
Stop sending video and audio to the Decklink output. Invokable command. Tears down the active output, releases the Decklink channel back to the system, and unlocks DecklinkOutputChannel, DisplayMode, and AudioChannels so they can be reconfigured. No-op if the target is already stopped. |
Log
Log — recent info, warning and error messages emitted by the target.

| Property | Description |
|---|---|
ComponentLog |
Per-component log buffer — recent info/warning/error messages emitted by the target (start, stop, configuration changes, playback errors). |
Performance and properties
Performance and properties — runtime stats and capture diagnostics.

| Property | Description |
|---|---|
Video width |
Width of the video signal currently sent to the Decklink output, in pixels (read-only). Reflects the resolution implied by the negotiated DisplayMode (e.g. 1920 for 1080p, 3840 for 2160p). 0 while playback is stopped. Useful from scripts to confirm the card opened at the expected resolution before driving downstream behaviour. |
Video height |
Height of the video signal currently sent to the Decklink output, in pixels (read-only). Reflects the vertical resolution implied by the negotiated DisplayMode (e.g. 1080 for 1080p, 2160 for 2160p). 0 while playback is stopped. |
Inherits from: AbstractTarget.
See also: Blackmagic Decklink Target v4 in Script Engine Objects.