Station Mapping : Blackmagic DeckLink Capture

From Userful Support
Jump to navigationJump to search

Copyright © 2016 Userful Corporation. All rights reserved.
(Updated 2016.12.02)

To return to the main documentation page, Click Here.


The Blackmagic DeckLink Capture session container casts output from any compatible playback device (e.g. PC, Mac, smartphone, tablet, gaming console, etc.) on a display or group of displays in a video wall.

Please consider the following points before using this session container:

  • You must install the Blackmagic Design Capture Card Driver from Control Center > System Operations > Additional Packages and Softwares
  • Supported Capture Card should be installed on the Userful host and firmware should be updated.
  • Directly connected HDCP (High-bandwidth Digital Content Protection) encrypted content will not play unless it is first run through an HDCP capable splitter.

Station Mapping: Creating Blackmagic DeckLink Capture Session Container

Creating Blackmagic Decklink Capture session container

Station Mapping allows you to bind a specific display or video wall to the Blackmagic DeckLink Capture session container. To create this session container:

  • Click on "New Session Container". From the drop-down menu select "Blackmagic DeckLink Capture" as the session type and give a name.
  • Select the Input device from the drop-down menu
  • Select the Backup Input from the drop-down menu
  • Select the Mode from the drop-down list (output resolution and frames per second)
  • Select a scaling option
  • Enable sound only if it is required
  • Enter the number of pixels to be cropped from left, right, top and bottom of the captured external device
  • Click "OK" to complete the process

Map Displays to the Blackmagic DeckLink Session Container

Once session container is created, stations or video wall can be "mapped" or assigned by simply dragging-and-dropping the station and video wall icons to the session container.

Note: Changes will not take effect until the "Apply" button is clicked.

The content of your output device will play on the station(s) or video wall mapped to this session container.

Troubleshooting Tips

This section outlines solution to the common problems encountered while using Blackmagic DeckLink Capture Cards.

Card not detected in the Control Center


  • Firmware not updated
Open terminal and at the command line type in the following command (sudo or root privileges are required through out the procedure) and reboot the system:
   $ sudo BlackmagicFirmwareUpdater update 0 
  • Blackmagic Design driver not installed
Navigate to the System Operations page in Control Center and install the desktopvideo package from Additional Packages.
  • Blackmagic Design driver installed but system not rebooted
Reboot the system

If the steps mentioned above do not lead to a solution, install Media Express using sudo yum install mediaexpress command on terminal. Manually verify that the capture card can detect and playback the plugged in source content in media express. If it fails, then there is a problem with source configuration rather than the software itself.

For more information about Media Express, visit Blackmagic site.

Black Screen(s) when launching the stations or video wall


  • Incorrect Color Space
Verify that the color space of the capture source is correct for your card. Please see Supported Capture Cards for details, if in doubt use YUV or YCbCr.
  • Non-Standard Resolutions not supported
If the source you're trying to capture is a laptop or PC and your display is a non-standard resolution, duplicating its screen to the capture card would not work. Resolutions such as 1366x768 or 1600x900 are not supported. To fix this:
  • in Windows (set your desktop to Extended)
  • in Linux (just uncheck the mirror displays option in the Display Settings)
  • in Mac (just uncheck the mirror displays option in the Display settings)
This will enable your laptop to correctly detect the display resolution from the capture card.
  • Remove any and all Splitters/Switches from the set up. Connect the source directly to the capture card.
  • HDCP content not supported
Verify that your capture source doesn't have an encrypted HDMI feed (HDCP). Note: If its a PC or Laptop or Game Console, verify that you're not playing any HDCP content (e.g. DVD or Blu-ray) or first run the HDMI signal through an HDCP compliant splitter before connecting it to the capture card to eliminate this potential cause.

Related Links