Social media streaming¶

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

Supported stream targets¶

Makalu 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)

Types of stream jobs¶

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

Stream job metadata¶

Depending on the stream job type, different metadata must 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:

Generic metadata¶

Generic stream jobs allow you to provide the following metadata:

Streaming workflow¶

Overview¶

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

1. Create a stream target via Makalu Configuration.

   Notice

   This is only required once for YouTube stream targets. If you want to stream to a single YouTube channel, you must create a stream target for the corresponding YouTube account. If you want to stream to multiple YouTube channels, you must 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 Makalu Traffic and/or Automation.

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

Creating an independent YouTube stream job¶

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

1. Open Makalu 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.

   

   Figure: Makalu Automation - Create independent YouTube stream job

   The metadata input screen is displayed.

   

   Figure: Makalu 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.

   

   Figure: Makalu Automation - Independent YouTube stream job created

Creating an independent generic stream job¶

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

1. Open Makalu 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.

   

   Figure: Makalu Automation - Create independent generic stream job

   The metadata input screen is displayed.

   

   Figure: Makalu 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.

   

   Figure: Makalu Automation - Independent generic stream job created

Creating a scheduled stream job¶

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

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

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

3. Use Makalu 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 clips, shows and playlists.

Use Makalu Traffic to assign a stream target to a clip¶

1. Open Makalu 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, by clicking the show title.

   The show properties are displayed.

4. Select the clip to which you want to assign the stream target, by clicking the clip title.

   The clip properties are displayed.

5. On the right in the Objects area select Stream Targets.

   Available stream targets are displayed below.

   

   Figure: Makalu Traffic - Available stream targets

   Tip

   You can switch between a presentation as card or list view, by clicking the Enable card view icon or Enable list view icon in the top right.

6. (Optional) To search for stream targets, use the available filters (e.g. Keyword).

7. To add a stream target to the clip, select a stream target and drag it on the Clip Addons list.

   

   Figure: Makalu Traffic - Add stream target to clip

   The stream target is added to the Clip Addons list.

   

   Figure: Makalu Traffic - Stream target added to clip

8. (Optional) Repeat the previous two steps to add more stream targets to the clip.

9. To edit the properties of the added stream target, expand it by clicking the Expand icon on the right.

   The addon properties are displayed in the Addon details area.

   Tip

   You can expand and collapse the Objects area via the Expand and Collapse icons in the top right. This is useful if you want to display an extensive list of addon properties. Collapsing the Objects area allows you to use most of the right side for displaying the details of an addon.

   Tip

   To delete an added stream target, proceed as follows:

   1 - Select one or more stream targets to be deleted, by activating the corresponding Action checkbox(es).

   2 - Click the Delete Addon icon .

   3 - In the subsequently displayed dialog, click Confirm.

The clip properties are saved automatically.

Send the corresponding playlist to playout¶

Send the playlist (that contains the clip to which you added the stream target) to playout as described in section Sending a playlist to playout

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

Use Makalu Automation to add the corresponding playlist to the rundown¶

Add the playlist to the rundown as described in section Adding a playlist to a rundown.

The playlist with the assigned stream target is added to the rundown in Makalu Automation.

Starting a YouTube stream¶

To start a YouTube stream, proceed as follows:

1. Open Makalu 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.

   

   Figure: Makalu Automation - YouTube stream job in status "Queued"

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

   

   Figure: Makalu Automation - Prepare YouTube stream job

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

   

   Figure: Makalu 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 the Open YouTube in new tab icon.

   The YouTube event opens in a new tab.

   

   Figure: Makalu Automation - Stream event becomes available on YouTube

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

   

   Figure: Makalu 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.

   

   Figure: Makalu Automation - Running YouTube stream job

   

   Figure: Makalu Automation - Viewing the stream on YouTube

Stopping a YouTube stream¶

To stop a YouTube stream, proceed as follows:

1. Open Makalu Automation.

2. Select the Stream Targets tab.

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

   

   Figure: Makalu Automation - Stopping a YouTube stream job

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

   

   Figure: Makalu Automation - Completed YouTube stream job

Restarting a completed YouTube stream¶

To restart a completed YouTube stream, proceed as follows:

1. Open Makalu Automation.

2. Select the Stream Targets tab.

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

   

   Figure: Makalu Automation - Restart completed YouTube stream job

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

Accessing a YouTube stream and sharing the stream link¶

To access a YouTube stream, proceed as follows:

1. Open Makalu Automation.

2. Select the Stream Targets tab.

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

   

   Figure: Makalu 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 the Copy to clipboard icon of the corresponding stream job.

   

   Figure: Makalu 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 Makalu 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.

   

   Figure: Makalu Automation - Prepare generic stream job

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

   

   Figure: Makalu Automation - Prepared generic stream job

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

   

   Figure: Makalu Automation - Start generic stream

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

   

   Figure: Makalu 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 must 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 Makalu 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.

   

   Figure: Makalu Automation - Stop generic stream

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

   

   Figure: Makalu Automation - Generic stream stopped

Restarting a completed generic stream¶

To restart a completed generic stream, proceed as follows:

1. Open Makalu 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.

   

   Figure: Makalu Automation - Restart generic stream

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

   

   Figure: Makalu Automation - Generic stream restarted