Videohub

Control Blackmagic Videohub routers over the Ethernet protocol (TCP), with support for both structured, menu-driven commands (labels, routing, locks, and serial settings) and manual raw command text. Available in the pro tier, VideoHub actions run on iOS, macOS, and Mac Catalyst, and send protocol-formatted commands to the configured host/port over TCP with line-ending handling for Videohub text framing.

Required Parameters

• host — required connection target (must not be blank).
• port — required TCP port, constrained to 1–65535 (default 9990).
• Use Raw Command + Raw Command when sending custom blocks directly.
• Command selection when raw mode is off, then that command’s parameters must be provided as required by the selected command.
• All index-based parameters are 0-based and accept 0+ integers.

Commands

Set Input Label

• Required inputs: inputIndex (0+), label.
• Command template: INPUT LABELS: {inputIndex} {label}.
• Applies to input label assignment.

Set Output Label

• Required inputs: outputIndex (0+), label.
• Command template: OUTPUT LABELS: {outputIndex} {label}.
• Applies to output label assignment.

Set Monitoring Output Label

• Required inputs: monitoringOutputIndex (0+), label.
• Command template: MONITORING OUTPUT LABELS: {monitoringOutputIndex} {label}.
• Supported on models with monitoring outputs only.

Set Serial Port Label

• Required inputs: serialPortIndex (0+), label.
• Command template: SERIAL PORT LABELS: {serialPortIndex} {label}.
• Supported on models with serial ports only.

Set Frame Label

• Required inputs: frameIndex (0+), label.
• Command template: FRAME LABELS: {frameIndex} {label}.
• Supported on VideoHub Workgroup models with processing units or frame buffers only.

Set Video Output Route

• Required inputs: outputIndex (0+), sourceIndex (0+).
• Command template: VIDEO OUTPUT ROUTING: {outputIndex} {sourceIndex}.
• Sets a source input to a video output.

Set Monitoring Output Route

• Required inputs: monitoringOutputIndex (0+), sourceIndex (0+).
• Command template: VIDEO MONITORING OUTPUT ROUTING: {monitoringOutputIndex} {sourceIndex}.
• Supported on models with monitoring outputs only.

Set Serial Port Route

• Required inputs: serialPortIndex (0+), sourceIndex (0+).
• Command template: SERIAL PORT ROUTING: {serialPortIndex} {sourceIndex}.
• Supported on models with serial ports only.

Set Processing Unit Route

• Required inputs: processingUnitIndex (0+), sourceIndex (0+).
• Command template: PROCESSING UNIT ROUTING: {processingUnitIndex} {sourceIndex}.
• Supported on VideoHub Workgroup models with processing units or frame buffers only.

Set Frame Buffer Route

• Required inputs: frameBufferIndex (0+), sourceIndex (0+).
• Command template: FRAME BUFFER ROUTING: {frameBufferIndex} {sourceIndex}.
• Supported on VideoHub Workgroup models with processing units or frame buffers only.

Set Video Output Lock

• Required inputs: outputIndex (0+), lockState.
• Command template: VIDEO OUTPUT LOCKS: {outputIndex} {lockState}.
• lockState: O (Lock), U (Unlock), F (Force Unlock). Default O.

Set Monitoring Output Lock

• Required inputs: monitoringOutputIndex (0+), lockState.
• Command template: MONITORING OUTPUT LOCKS: {monitoringOutputIndex} {lockState}.
• lockState: O/U/F as above.
• Supported on models with monitoring outputs only.

Set Serial Port Lock

• Required inputs: serialPortIndex (0+), lockState.
• Command template: SERIAL PORT LOCKS: {serialPortIndex} {lockState}.
• lockState: O/U/F as above.
• Supported on models with serial ports only.

Set Processing Unit Lock

• Required inputs: processingUnitIndex (0+), lockState.
• Command template: PROCESSING UNIT LOCKS: {processingUnitIndex} {lockState}.
• lockState: O/U/F as above.
• Supported on VideoHub Workgroup models with processing units or frame buffers only.

Set Frame Buffer Lock

• Required inputs: frameBufferIndex (0+), lockState.
• Command template: FRAME BUFFER LOCKS: {frameBufferIndex} {lockState}.
• lockState: O/U/F as above.
• Supported on VideoHub Workgroup models with processing units or frame buffers only.

Set Serial Port Direction

• Required inputs: serialPortIndex (0+), direction.
• Command template: SERIAL PORT DIRECTIONS: {serialPortIndex} {direction}.
• direction: control, slave, auto (default auto).

Raw Command

• Required input: rawCommand (non-empty multiline text).
• Bypasses the structured command picker and sends the provided block directly.
• The terminating blank line is appended automatically; best for multi-entry bulk updates.