Customer Sign In


Live Events

Tutorial thumbnail

Summary (Linux only) Learn how to stream a live event.

Skill level required Intermediate

Time to complete 15-30 minutes

Things you'll need
  • A Linux computer with a Blackmagic DeckLink SDI capture card
  • An audio and video source

Note: This tutorial sets up a basic live event. Unlock the true power of live events by taking advantage of features, such as live event scheduling, UDP streaming, Mac support, and API-driven workflows.
Learn more.


Live events are perfect for concerts, lectures, sporting events or any other live content that will be broadcast for a finite amount of time.

Live events provide the following capabilities:

  • Effortlessly scale to massive audiences.
  • Start the event at any time and present your users with looped video until the event begins.
  • Immediately replay the event on-demand upon completion.
  • Insert ad breaks, integrate with a third-party ad server, and deliver unique ads to each of your viewers.

Step 1. Set up a Live Slicer

A Live Slicer is required to prepare an audio/video feed into a live stream that will be broadcast to all of your viewers. Set up the latest version of the Live Slicer on a Linux computer.

Blackmagic Only: Install the Live Slicer on a computer that contains a Blackmagic DeckLink SDI capture card.

Perform the following steps:

  1. Install the latest version of the Live Slicer on a Linux computer.
    1. From a Linux computer, sign in to the Uplynk CMS.
    2. From the lower-left hand corner, click Download Slicer.
    3. Click Download Slicer.
    4. Extract the compressed file to the desired directory.
      $ tar xvf- uplynk_slicer_linux_64-17031700.tbz2
    5. Navigate to the newly created directory.
      $ cd uplynk_slicer_linux_64-17031700-master/
    6. Run install_live.
      $ sudo ./install_live
      upLynk Live Slicer installed. Please edit /etc/uplynk.conf to configure, then run "start uplynk_liveslicer" to start.
    7. Open /etc/uplynk.conf in a text editor. A sample configuration file is shown below.
      description: Live Capture   # A description that will be assigned to new assets.
        username:  # The email address used to authenticate the Live Slicer.
        password: samplepassword    # The password associated with the above login credential.
        slicerID: education         # The ID of the Live Slicer. 
        autoexpire_age: 24          # The number of hours until assets get deleted (0= do not delete).
        input: blackmagic           # The input source for the signal.
        card: 0                     # The card number for BlackMagic capture cards.
        capture_mode: auto          # The Blackmagic capture mode. See "liveslicer -list."
        audio_layout: stereo 1      # The channel layout. Valid values are: stereo #, 5.1, 7.1
        gain: 0.0                   # The number of decibels of gain to apply to the audio.
        capture_delay: 0            # The delay, in seconds, to add to match timecodes.
        SCTE104_DID: 0x41           # The DID number to use for SCTE104 triggers.
        SCTE104_SDID: 0x07          # The SDID number to use for SCTE104 triggers.
        captions_DID: 0x61          # The DID number to use for closed captions.
        captions_SDID: 0x01         # The SDID number to use for closed captions.
        ancillary_scan: off         # Set to "on" to scan all ancillary lines.
        ancillary_lines: 9, 13      # The lines to be scanned when "ancillary_scan" is set to "off."
        api_port:   # The port number to listen on for API calls.
  2. Set the username option to the email address associated with your Uplynk account.
  3. If present, delete the password line.
    password: mypassword
  4. If missing, add a line for the apikey setting. Set it to your secret API key. View your API keys by clicking the Advanced tab and then clicking Playback Tokens from the side navigation tab.
    apikey: abcDEFghiJKLmnoPQRtuvWXYz123ABCdefGHIJKL
  5. Set the slicerID option to "marketingslicer."
    slicerID: marketingslicer
  6. Set the card option to the number assigned to the Blackmagic capture card that will generate the source feed.
    card: 1
  7. Set the port on which the Live Slicer will listen for API requests.
    api_port: 65009
  8. Enable the Live Events Dashboard's live preview capability.
    preview: on
  9. Set a limit to the number simultaneous viewers of a live preview.
    live_preview_max_viewers: 2
  10. Configure the Live Slicer to generate and install a SSL certificate.

    Note: Alternatively, manually generate a SSL certificate and then configure the Live Slicer to use it.
    Learn more.

    1. Set the ssl_port setting to the desired port.
      ssl_port: 65010
    2. If present, remove the ssl_cert and the manual_ip settings.
  11. Start the Live Slicer through the following command:
    sudo start uplynk_liveslicer
  12. Set up the Blackmagic capture card to capture the audio/video feed.
    1. Connect the audio and video source to the Blackmagic capture card.
    2. Open Blackmagic system preferences and then configure the above connections as input sources.
    3. Open Preferences (Edit>Preferences) and then set a project format, capture file format, and storage location.
    4. Close Preferences and click on the Log and Capture tab.
    5. Click Capture. The Live Slicer will automatically pick up the feed.

Step 2. Create a Live Event in the CMS

Create a basic live event configuration that will stream the audio/video feed generated by the above Live Slicer.

  1. Sign in to the Uplynk CMS.
  2. From the LIVE EVENTS tab in the CMS, click + Create Event.
  3. In the Event Name option, type "My Live Event."
  4. Click Create & Edit. Click Create & Edit
  5. From the Config tab, set the Require DRM option to "No."
  6. From the Slicers tab, find the Slicer ID option and then type the value assigned to the slicerID setting (i.e., marketingslicer) in the Live Slicer configuration file. Click + Add. Add Live Slicer ID.
  7. Click Save.

Step 3. Set up a Media Player.

A media player that points to the live event must be distributed to your viewers.

  1. Open a text editor.
  2. Insert the following HTML code:
    <!DOCTYPE html>
  3. From within the CMS, open the live event created above.
  4. Navigate to the Playback tab.
  5. Click copy which appears next to the Embed HTML option.
  6. From the text editor, paste the copied text within the <body> tags. The resulting HTML code should look similar to the code provided below.
    <!DOCTYPE html>
    		<iframe style="border:none" width="640" height="480" src=""></iframe>
  7. Save the above code as a HTML page (e.g., myliveevent.html).
  8. Load the above web page and verify that it loads pre-event slate.

Step 4. Broadcast a Live Event.

Broadcast a live event through the Live Events Dashboard.

  1. From the LIVE EVENTS tab in the CMS, click the live event created above.
  2. Click Open Dashboard.
  3. Verify that a connection was established to the Live Slicer.
    The Live Slicer should be highlighted in green as illustrated below. Click 'Live Slicer Connectivity'
  4. Test the live event.
    1. Click Enter Event.
    2. Click Start Test.
  5. Monitor the live event to identify its starting point and then start it by clicking Start Event twice.
  6. Monitor the live stream to identify the ending point of the live event and then stop it by clicking Stop Event twice.

Streaming the Live Event as On-Demand Content

Upon completing your live event, it will be added to the CMS library. This allows the live event to be played back as on-demand content using the playback URL, test players, or HTML embed code associated with the live event or the VOD asset generated from it.