# Live Streaming via RTMP

{% hint style="info" %}
Live Streaming is a complementary feature of our paid Whereby Embedded plans. You can review the pricing and options [on our site](https://whereby.com/information/embedded/pricing/).
{% endhint %}

{% hint style="danger" %}
Live Streaming is not HIPAA-compliant. Make sure you don't include any live streaming configuration when you create rooms.
{% endhint %}

## Setup

Create a meeting with live streaming set up for others to use, such as a teacher or an event organizer. The live stream is fixed and cannot be changed inside the room afterward. Follow along with our video streaming SDK to get this started for your use case.&#x20;

{% embed url="<https://www.youtube.com/watch?v=wAEwDL6JMMg>" %}
How to set up live streaming in Whereby Embedded
{% endembed %}

### Create a live streaming meeting with the API

When creating a meeting [via our API](https://docs.whereby.com/reference/whereby-rest-api-reference/meetings), you can pass your platforms `RTMP URL` and include the `stream key` separated by a forward slash. Then, specify how you'd like the live stream to begin: "**Automatic**", "**Manual**", or "**Prompt**" by including an in room message to the host.

You'll have these same options when creating a meeting [via our dashboard](https://docs.whereby.com/whereby-product-features/using-the-rest-api/using-create-a-room).

### Obtaining live streaming info

{% tabs %}
{% tab title="YouTube" %}
{% hint style="info" %}
If you haven't live streamed before, in order to access your stream key on YouTube, you must go through the initial stream setup, which includes a 24 hour account processing period.
{% endhint %}

Your stream key and URL can be located under the "Stream Settings" tab once you've completed the initial setup. Google has documentation on this topic in their article "[Manage live stream settings](https://support.google.com/youtube/answer/9854503)".

![](https://content.gitbook.com/content/LH2UIJDLc2EElQvYUxWX/blobs/NDlK4GZnfezfkWU73J9T/YouTube%20Settings.png)
{% endtab %}

{% tab title="Twitch" %}
You can obtain a stream key from the "Stream" section of the Twitch creator dashboard. For more information, you can visit Twitch's [Support Center](https://help.twitch.tv/s/article/creator-dashboard).

1. Log into your Twitch account
2. Click on your profile icon in the top right and navigate to "Creator Dashboard"
3. On the left side of the screen select **Settings->Stream**
4. The stream key is located at the very top of the page

![](https://content.gitbook.com/content/LH2UIJDLc2EElQvYUxWX/blobs/yEdWTtXOuX1YJqUFamDf/Twitch%20Settings.png)

You can enter your stream key as part of the [broadcast URL](https://dev.twitch.tv/docs/video-broadcast). Twitch provides additional insight on choosing a broadcast URL in their [support documentation](https://help.twitch.tv/s/article/guide-to-broadcast-health-and-using-twitch-inspector?language=en_US#HowtoChooseaTwitchIngestServer).
{% endtab %}

{% tab title="Facebook" %}
For in depth instructions on how to go live via Facebook, we recommend reviewing their support article "[How do I go live on Facebook](https://www.facebook.com/help/587160588142067)".

You'll get started by [creating a live stream](https://www.facebook.com/live/create), create a key, then copy and paste the server URL and key into Whereby.

![](https://content.gitbook.com/content/LH2UIJDLc2EElQvYUxWX/blobs/oEuQ0x82qYWKu3UY1xgk/Facebook%20Settings.png)
{% endtab %}

{% tab title="Vimeo" %}
Going live on Vimeo does require a paid Vimeo Premium or Vimeo Enterprise membership. You can view their plans and pricing on [their website](https://vimeo.zendesk.com/hc/en-us/articles/115012811168#h_60c83788-04d4-4353-8a3a-cd0d0bb8b6bc).

Vimeo provides an in depth guide on creating a live event and setting up RTMP connections in their support document "[Create and go live to an event](https://vimeo.zendesk.com/hc/en-us/articles/115012811168#h_60c83788-04d4-4353-8a3a-cd0d0bb8b6bc)". During the process, they provide a link and stream key that you can copy and use in Whereby.

![](https://content.gitbook.com/content/LH2UIJDLc2EElQvYUxWX/blobs/I89xBrlKmf7DscPFwJ3w/Vimeo%20settings.png)
{% endtab %}
{% endtabs %}

## Use cases

* Hosting webinars that exceed the maximum amount of participants and [Viewers](https://docs.whereby.com/user-roles-and-privileges#viewers).
* Alternative solution to Google's WebRTC for Android.
* Embed realtime video chat&#x20;


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.whereby.com/whereby-product-features/streaming-with-embedded.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
