Social media streaming

Social media streaming is a q.air module that allows you to distribute the output of each q.air Automation playout channel as a stream to social media, video platforms and service providers.

Supported stream targets

q.air supports the following target platforms/protocols:

  • YouTube
  • Facebook
  • LinkedIn
  • Twitch
  • Generic RTMP (any target that supports RTMP streams)
  • Generic RTMPS (any target that supports RTMPS streams)

Notice

q.air also supports static routing stream targets that enable you to permanently stream any live source to any valid target, without having to schedule it in a rundown. These stream targets are managed via q.air Stream Control and are described in section Live sources and stream targets.

Types of stream jobs

q.air differentiates between the following types of stream jobs, that can both be created via q.air Automation:

Type Description
Independent
  • has to be created manually
  • is independent of the rundown
  • does not have a time reference
Scheduled
  • is created automatically when a playlist with an assigned stream target is added to the rundown
  • is assigned to a playlist, show or clip in the rundown
  • has a time reference
  • is recognizable by a small clock icon in the Platform column in the job list

Stream job metadata

Depending on the stream job type, different metadata has to be provided when creating a new stream job. These differences are described in the following.

YouTube metadata

YouTube stream jobs allow you to provide the following metadata:

Metadata element Mandatory Description
Account Yes The YouTube account to be used as target (as configured via q.air Configuration).
Source Yes The stream that is used as source and streamed to the target.
Event Yes The name/title of the YouTube event, that will be displayed for viewers on YouTube.
Description No The description of the YouTube event, that will be displayed for viewers on YouTube.
Starttime Yes The planned start date and time of the YouTube event.

Generic metadata

Generic stream jobs allow you to provide the following metadata:

Metadata element Mandatory Description
Target Yes The target platform/protocol to be used. Available options:
  • YouTube
  • Facebook
  • LinkedIn
  • Twitch
  • RTMP
  • RTMPS
Source Yes The stream that is used as source and streamed to the target.
Title Yes The title of the stream event.
Description No The description of the stream event.
Stream Url Yes The target stream URL.
Stream Key Yes The stream key to be used.
Credentials No Enable to provide additional user credentials for authentication. Disable to send the stream without additional user credentials.
Username No The username to be used as part of the credentials (only available if the Credentials checkbox is activated).
Password No The password to be used as part of the credentials (only available if the Credentials checkbox is activated).
Starttime Yes The planned start date and time of the stream event.

Streaming workflow

Overview

To stream content, in summary the following steps are required:

  1. Create a stream target via q.air Configuration.

    Notice

    This is only required once for YouTube stream targets. If you want to stream to a single YouTube channel, you have to create a stream target for the corresponding YouTube account. If you want to stream to multiple YouTube channels, you have to create a stream target for each of your accounts.

    Generic stream targets do not have to be created manually, as they are already created during the system provisioning.

  2. Create an independent or scheduled stream job for the stream target via q.air Traffic and/or Automation.

  3. Manually prepare, start and stop the stream via q.air Automation.

Creating an independent YouTube stream job

To create an independent YouTube stream job, proceed as follows:

  1. Open q.air Automation.

  2. On the right side select the Stream Targets tab.

  3. In the Predefined Targets section, click the “+” icon of the YouTube stream target to be used.

    q.air Automation - Create independent YouTube stream job

    Figure: q.air Automation - Create independent YouTube stream job

    The metadata input screen is displayed.

    q.air Automation - Create independent YouTube stream job - Metadata input screen

    Figure: q.air Automation - Create independent YouTube stream job - Metadata input screen

  4. Enter the metadata of the stream target.

    Notice

    You can only apply the changes if all mandatory fields are filled in and the selected start time lies in the future.

  5. Click Apply.

    The stream job is created and added to the job list.

    q.air Automation - Independent YouTube stream job created

    Figure: q.air Automation - Independent YouTube stream job created

Creating an independent generic stream job

To create an independent generic stream job, proceed as follows:

  1. Open q.air Automation.

  2. On the right side select the Stream Targets tab.

  3. In the Predefined Targets section, click the “+” icon of the generic stream target to be used.

    q.air Automation - Create independent generic stream job

    Figure: q.air Automation - Create independent generic stream job

    The metadata input screen is displayed.

    q.air Automation - Create independent generic stream job - Metadata input screen

    Figure: q.air Automation - Create independent generic stream job - Metadata input screen

  4. Enter the metadata of the stream target.

    Notice

    You can only apply the changes if all mandatory fields are filled in and the selected start time lies in the future.

    Tip

    If you want to use the generic stream job for streaming to YouTube, you can retrieve the required values for streamurl and streamkey as follows:

    1. Log in to your YouTube account.
    2. In the upper right area click Create > Go Live.
      The required information is displayed in the Stream Settings section.
    3. Copy the stream key and the stream URL and paste them into the required mandatory fields.
  5. Click Apply.

    The stream job is created and added to the job list.

    q.air Automation - Independent generic stream job created

    Figure: q.air Automation - Independent generic stream job created

Creating a scheduled stream job

In summary, creating a scheduled stream job requires the following steps:

  1. Use q.air Traffic to assign a stream target to a playlist, show or clip.

  2. Send the corresponding playlist (that includes the show or clip you assigned the stream target to) to playout.

  3. Use q.air Automation to add the corresponding playlist to the rundown.

These steps are described in detail below, based on the example of adding a YouTube stream target to a clip. They apply to any type of stream target and the mechanism is the same for both playlists and shows.

To assign a YouTube stream target to a clip, proceed as follows:

  1. Open q.air Traffic.

  2. In the left sidebar, select Shows.

    The available shows are displayed.

  3. Select the show that contains the clip to which you want to add a stream target.

    A new tab is opened for editing the clip details.

  4. Select the clip to which you want to assign the stream target to in the lower right corner, by activating the corresponding Action checkbox.

  5. Click the Edit Clip button.

    q.air Traffic - Select Clip

    Figure: q.air Traffic - Select Clip

    A new tab is opened for editing the clip details.

  6. In the left sidebar of the newly opened clip tab select Secondary events and click Stream Targets.

    Available stream targets of the selected type are displayed in the Stream Targets area to the right.

    q.air Traffic - Secondary events

    Figure: q.air Traffic - Secondary events

  7. Select a stream target and drag it onto the Drop Zone in the Clip Addons area.

    q.air Traffic - Stream targets added to clip addons

    Figure: q.air Traffic - Stream target added to clip addons

  8. Edit the properties of an added stream target, by selecting it in the Clip Addons list and click the Edit Addon button.

    The clip addon details are displayed to the right.

    q.air Traffic - Edit clip addon details

    Figure: q.air Traffic - Edit clip addon details

  9. Change the addon details as required.

  10. To save the addon settings, in the Clip Addon details area click Update.

    The clip and its stream targets are saved.

  11. To close the tab with the clip details, click Close in the Clip Properties area.

    The tab is closed.

    q.air Traffic - Update and close

    Figure: q.air Traffic - Update and close

  12. In the left sidebar, select Playlists.

    The available playlists are displayed.

  13. Select the Playlist that contains the clip to which you added the stream target.

    A new tab is opened for editing the playlist details.

  14. In the Playlist Properties area click Send to Playout.

    q.air Traffic - Send to playout

    Figure: q.air Traffic - Send to playout

    The select playout channel dialog is displayed.

    q.air Traffic - Select playout channel

    Figure: q.air Traffic - Select playout channel

  15. Select the playout channel that you want to send the playlist to.

  16. Click Confirm.

    The playlist with the assigned stream target is made available for the selected channel in q.air Automation.

  17. Open q.air Automation.

  18. Add the corresponding playlist to the rundown.

    Based on the stream target that is used in the playlist, a stream job is automatically added to the job list. It is recognizable by a clock icon in the "Platform" column

    q.air Automation - Scheduled stream job added to job list

    Figure: q.air Automation - Scheduled stream job added to job list

Starting a YouTube stream

To start a YouTube stream, proceed as follows:

  1. Open q.air Automation.

  2. Select the Stream Targets tab.

  3. If the corresponding stream job in the Joblist is in status Unknown, wait until it changes to Queued.

    Notice

    If the corresponding stream job was added to the job list shortly before, this may take a few seconds.

    q.air Automation - YouTube stream job in status "Queued"

    Figure: q.air Automation - YouTube stream job in status "Queued"

  4. If the stream job is in status Queued, in the Action column click the Prepare icon.

    q.air Automation - Prepare YouTube stream job

    Figure: q.air Automation - Prepare YouTube stream job

    The stream job status first changes to "Preparing" and after a few seconds to "Prepared".

    q.air Automation - Prepared YouTube stream job

    Figure: q.air Automation - Prepared YouTube stream job

    Tip

    When the stream job changes the status to Prepared, the corresponding event becomes available on YouTube.

    To access the event, click on the Open YouTube link icon Open YouTube in new tab icon.

    The YouTube event opens in a new tab.

    q.air Automation - Stream event becomes available on YouTube

    Figure: q.air Automation - Stream event becomes available on YouTube

  5. To start the stream, click the Go live icon.

    q.air Automation - Go live on YouTube

    Figure: q.air Automation - Go live on YouTube

    The stream job status changes to "Starting" and then to "Running". From this point on the actual stream can be viewed on YouTube.

    q.air Automation - Running YouTube stream job

    Figure: q.air Automation - Running YouTube stream job

    q.air Automation - Viewing the stream on YouTube

    Figure: q.air Automation - Viewing the stream on YouTube

Stopping a YouTube stream

To stop a YouTube stream, proceed as follows:

  1. Open q.air Automation.

  2. Select the Stream Targets tab.

  3. Click on the Stop icon of the stream job to be stopped.

    q.air Automation - Stopping a YouTube stream job

    Figure: q.air Automation - Stopping a YouTube stream job

    The stream job status changes from "Running" to "Stopping" to "Completed". The stream event on YouTube is finished.

    q.air Automation - Completed YouTube stream job

    Figure: q.air Automation - Completed YouTube stream job

Restarting a completed YouTube stream

To restart a completed YouTube stream, proceed as follows:

  1. Open q.air Automation.

  2. Select the Stream Targets tab.

  3. Click the Queue icon of the completed YouTube stream to be restarted.

    q.air Automation - Restart completed YouTube stream job

    Figure: q.air Automation - Restart completed YouTube stream job

  4. Repeat steps 3-7 described in section Starting a YouTube stream

Notice

A YouTube stream event is not available until the status of the corresponding stream job changes to Prepared.

Notice

Privacy settings and access permissions affect who can access a YouTube stream.

To access a YouTube stream, proceed as follows:

  1. Open q.air Automation.

  2. Select the Stream Targets tab.

  3. In the Joblist click on the Open YouTube in new tab icon of the corresponding stream job.

    q.air Automation - Accessing a YouTube stream

    Figure: q.air Automation - Accessing a YouTube stream

    The YouTube stream opens in a new tab.

To share the stream link, proceed as follows:

  1. In the Joblist click on the Copy to clipboard icon of the corresponding stream job.

    q.air Automation - Sharing a YouTube stream link

    Figure: q.air Automation - Sharing a YouTube stream link

  2. Share the copied link, e.g. by sending it via email or sharing it via social media.

Starting a generic stream

To start a generic stream, proceed as follows:

  1. Open q.air Automation.

  2. Select the Stream Targets tab.

    Notice

    The generic stream job to be started should be in status Queued.

  3. In the Action column click the Prepare icon of the generic stream job to be started.

    q.air Automation - Prepare generic stream job

    Figure: q.air Automation - Prepare generic stream job

    The status of the generic stream job changes to "Preparing" and then to "Prepared".

    q.air Automation - Prepared generic stream job

    Figure: q.air Automation - Prepared generic stream job

  4. To start the stream, click the Start icon.

    q.air Automation - Start generic stream

    Figure: q.air Automation - Start generic stream

    The stream job status changes to "Started" and then to "Running".

    q.air Automation - Generic stream job started

    Figure: q.air Automation - Generic stream job started

    From this point on the stream is running and sent to the selected stream URL.

    Notice

    How you can access the stream depends on the selected target. If you stream to platforms like YouTube, Facebook, LinkedIn or Twitch, you can access the stream directly via the corresponding target platform.

    If you stream via RTMP or RTMPS to a streaming server (e.g. Wowza), you can access the stream based on the options the server provides. This could for example be an HLS preview of the stream. In this case you can access the stream via the corresponding URL.

    Notice

    Not all web stream formats can be played directly in Google Chrome. Depending on the format of the provided web stream, playback may only be possible via additional browser add-ons.

    This e.g. applies to HLS streams that are provided as M3U8 playlist files. To open these streams in Chrome, you have to install an appropriate add-on, like Play HLS M3u8. If the add-on is installed, the stream is opened and played automatically. Otherwise only the corresponding M3U8 file is downloaded.

Stopping a generic stream

To stop a generic stream, proceed as follows:

  1. Open q.air Automation.

  2. Select the Stream Targets tab.

    Notice

    The generic stream job to be stopped should be in status Started.

  3. To stop a generic stream, click the Stop icon.

    q.air Automation - Stop generic stream

    Figure: q.air Automation - Stop generic stream

    The generic stream is stopped and the status changes from "Started" to "Stopped".

    q.air Automation - Generic stream stopped

    Figure: q.air Automation - Generic stream stopped

Restarting a completed generic stream

To restart a completed generic stream, proceed as follows:

  1. Open q.air Automation.

  2. Select the Stream Targets tab.

    Notice

    The generic stream job to be stopped should be in status Stopped.

  3. Click the Start icon of the generic stream job to be restarted.

    q.air Automation - Restart generic stream

    Figure: q.air Automation - Restart generic stream

    The stream is restarted and the status changes from "Stopped" to "Started" and then to "Running".

    q.air Automation - Generic stream restarted

    Figure: q.air Automation - Generic stream restarted


Last update: 2021-04-15