Section: User Commands (1)
Updated: October 2020
videohubctrl - Blackmagic Design Videohub SDI router control
videohubctrl --host <host> ..other options..
videohubctrl implements the simple text based network protocol for
controlling Blackmagic Design Videohub SDI router devices. The
program is tested with Blackmagic Design Micro Videohub and
probably works with other Videohub models.
videohubctrl currently displays and can configure:
- Video input port names
- Video output port names, routing and locking
- Input/Output port statuses
- Monitoring video output port names, routing and locking
- Serial ports names, routing, locking and directions
- Processing units
- Alarms status
- -h, --host <host>
Set the device host name. It can be an IP address or host name. You
can set VIDEOHUB_HOST environment variable instead of using
- -p, --port <port>
Set the device port. You can set VIDEOHUB_PORT environment
variable instead of using this option. The default port is 9990.
- -t, --timeout <seconds>
Set the timeout in seconds for connect and read. The default is 15 seconds,
min vlue is 1 and max value is 60
- -i, --info
Show full device info. This is the default command if none is set.
The command shows the equivalent of running all --list-XXX commands.
- -m, --monitor
Display the Videohub configuration and updates it in real-time as it
is changed. The monitor shows config changes immediately as they happen.
The device is not being polled, instead the videohub protocol is designed
in such way that every client receives changes on the fly.
- -b, --backup
Show the command line that will restore the device to it's configuration.
Display main device info including model, number of ports, etc.
Display device video inputs. Port numbers, names, how many outputs an
input is being routed to, the list of the outputs and the port status
The port statuses (type) are reported by Universal Videohub and can be
- Empty means that the device do not support port status.
x - The port type is "None". This means that the port is not
installed in the device.
B - The port type is "BNC".
o - The port type is "Optical".
T - The port type is "Thunderbolt".
Display device video outputs. Port numbers, names, locking status, which
input is routed to a given output and the port status (type).
There are two locking statuses:
L - The port is locked by another IP address (user)
O - The port is locked by me (from my IP address)
The port status field (s) have the same format as input ports (described
in --list-vinputs option).
Display device monitoring outputs. Port numbers, names, locking status and
which input is routed to a given output. The locking statuses are the
same as video input and output ports.
Display device serial ports. Port numbers, names, locking status, directions
and how serial ports are routed. The locking statuses are the same as video
input, output ports and monitoring ports.
Display device procesing units. Unit numbers, locking status and connected
Display stored frame buffers.
Display current alarms status.
- --set-name <name>
Set the device "friendly name". This name can be used as a device identifier.
Only some Videohub models support this functionality.
Everywhere where port needs to be set, you can use the port number or the
port name. You can use only port names that were already configured in
previous session. Trying to set a name and then reference it in the next
command will fail. Using port numbers always works.
- --in-name <in_X> <name>
Set video input port X name.
- --in-output <in_X> <out_Y>
Set video input X to be outputted via output Y.
- --in-monitor <in_X> <mout_Y>
Set video input X to be outputted via monitoring port Y.
- --out-name <out_X> <name>
Set video output port X name.
- --out-input <out_X> <in_Y>
Connect video output X to video input Y.
- --out-lock <out_X>
Lock output port X.
- --out-unlock <out_X>
Unlock output port X. If the port is locked by somebody else the
port would be forcefully unlocked.
MONITORING OUTPUTS CONFIGURATION
- --mon-name <mout_X> <name>
Set monitoring output port X name.
- --mon-input <mout_X> <in_Y>
Connect monitoring output X to video input Y.
- --mon-lock <mout_X>
Lock monitoring output port X.
- --mon-unlock <mout_X>
Unlock monitoring output port X. If the port is locked by somebody
else the port would be forcefully unlocked.
SERIAL PORTS CONFIGURATION
- --ser-name <ser_X> <name>
Set serial port X name.
- --ser-connect <ser_X> <ser_Y>
Connect serial port X to serial port Y. This option have two aliases --ser-input
- --ser-clear <ser_X>
Disconnect serial port X from the connected serial port.
- --ser-lock <ser_X>
Lock serial port X.
- --ser-unlock <ser_X>
Unlock serial port X. If the port is locked by somebody else the
port would be forcefully unlocked.
- --ser-dir <ser_X> <in|out|auto>
Set serial port X direction. There are three possible settings for
in - input/control/Workstation
out - output/slave/Deck
auto - Automatic in/out
PROCESSING UNITS CONFIGURATION
- --pu-input <pu_X> <in_Y>
Connect processing unit X to video input port Y.
- --pu-clear <pu_X>
Disconnect processing unit X from the connected input port.
- --pu-lock <pu_X>
Lock processing unit port X.
- --pu-unlock <pu_X>
Unlock processing unit port X. If the processing unit is locked by somebody
else the port would be forcefully unlocked.
- --fr-name <fr_X> <name>
Set frame X name.
- --fr-output <fr_X> <out_Y>
Output frame X to video output port Y.
- --fr-clear <fr_X>
Disconnect frame X from the connected output port.
- --fr-lock <fr_X>
Lock frame X.
- --fr-unlock <fr_X>
Unlock frame X. If the frame is locked by somebody else the port would be
- -T, --test <file>
Read commands from the <file> instead of connecting to a real
device. This allows testing the program without having access
to a device.
- -d, --debug
Enable debugging output. Use this option more times to increase
- -q, --quiet
Suppress warnings about unsupported commands.
- -V, --version
Show program name and version.
- -H, --help
Show program usage text.
Set the device host name.
Set the device port.
To get a quick start here are some example command lines.
# Rename video output
videohubctrl -h sdi --out-name 8 "Output 8 - test"
videohubctrl -h sdi --out-name "Output 8 - test" "Output 8"
# Rename video input
videohubctrl -h sdi --in-name 4 "Windows 4 HD"
videohubctrl -h sdi --in-name "Windows 4 HD" "CPlay4"
# Lock and then unlock output 16 (unlock assumes that the port is
# named Output 16). The host name is set via env variable.
videohubctrl --out-lock 16
videohubctrl --out-unlock "Output 16"
# Set two outputs to receive from the same input using port names
videohubctrl -h sdi --out-input "Output 8" "Windows 4 HD"
videohubctrl -h sdi --out-input "Output 7" "Windows 4 HD"
# Set one input to go out two outputs and two monitoring ports
videohubctrl -h sdi --in-output "Windows 4 HD" "Output 8" \
--in-output "Windows 4 HD" "Output 7" \
--in-monitor "Windows 4 HD" "Monitor 1" \
--in-monitor "Windows 4 HD" "Monitor 2"
# Run several commands at once
# Rename video input 11 and 12
# Rename video output 5,
# Set output 5 to receive from input 12
# Lock output 5
videohubctrl --host sdi \
--in-name 11 "Test input" \
--in-name 12 "Playout input" \
--out-name 5 "Encoder h264" \
--out-input 5 12 \
# This fails. It tries to use name that is not previously configured.
videohubctrl -h sdi --out-name 1 "Test output" \
--out-name "Test output" "Other name"
See the README file for more information. If you have questions,
remarks, problems or you just want to contact the developer, write
- For more info, see the website at
Written by Georgi Chorbadzhiyski <email@example.com>
videohubctrl is released under MIT license.
- MAIN OPTIONS
- CONFIGURATION COMMANDS
- INPUTS CONFIGURATION
- OUTPUTS CONFIGURATION
- MONITORING OUTPUTS CONFIGURATION
- SERIAL PORTS CONFIGURATION
- PROCESSING UNITS CONFIGURATION
- FRAMES CONFIGURATION
- MISC OPTIONS
- ENVIRONMENT VARIABLES
- SEE ALSO
This document was created by
using the manual pages.
Time: 14:13:04 GMT, October 26, 2020