> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hop.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Pipe Getting Started

> Pipe allows you to deliver real-time livestreams to users across the globe withour worrying about scale. As a developer, Pipe is easy to integrate - there's only 3 steps to getting your first broadcast going.

* [Easy mode (use Console UI & OBS)](#easy-mode)
* [Advanced mode (use our SDK/API & ffmpeg)](#advanced-mode)

## Easy Mode

We'll create a room, stream to it through OBS, then view the stream through the
Pipe testing tool.

### Creating the Room

Head over to the [Rooms tab](https://console.hop.io/pipe/rooms) under the Pipe
page in the Console.

Click "Create Room" in the top right. You'll be presented with a modal:

<img src="https://mintcdn.com/hopio/cq2ctXa-N8Jv0svA/images/pipe-create-room-modal.webp?fit=max&auto=format&n=cq2ctXa-N8Jv0svA&q=85&s=39875063a6256158268f34fd522997e9" alt="" width="900" height="822" data-path="images/pipe-create-room-modal.webp" />

For this example, stick to **RTMP** for the ingest protocol and **LLHLS** for
delivery. You can optionally give the stream a name.

Click **Create Room**.

<img src="https://mintcdn.com/hopio/cq2ctXa-N8Jv0svA/images/pipe-room-created-modal.webp?fit=max&auto=format&n=cq2ctXa-N8Jv0svA&q=85&s=95cd750a5e859fa78443dd01cb5362ea" alt="" width="900" height="730" data-path="images/pipe-room-created-modal.webp" />

Use the <span><img style={{display: "inline", height: "1em", margin: "0px 3px"}} src="https://mintlify.s3.us-west-1.amazonaws.com/hopio/icons/clipboard.png" /></span> button to copy the **Ingest Endpoint** to
your clipboard.

### Streaming via OBS

[OBS](https://obsproject.com/) allows you to quickly and easily set up a
livestream from your machine. Once downloaded, head over to the "Stream" tab in
the Settings page:

<img src="https://mintcdn.com/hopio/cq2ctXa-N8Jv0svA/images/obs-stream-1.webp?fit=max&auto=format&n=cq2ctXa-N8Jv0svA&q=85&s=fe5f4e4e8a8b2fc256ec3d16ca1e9505" alt="" width="1978" height="494" data-path="images/obs-stream-1.webp" />

For **Service**, Select **Custom**.

Paste the Ingest Endpoint you copied above into the **Server** input. It'll look
something like this:

```
rtmp://cinnamon-iad1-prd.origin.hopvideo.net/v.vanilla/psk_c184ZTM2Y2Q3YzMxNDU3NjZjMmNkYmE5YzQzNTI2MThhOV8zMjUyOTM4ODQzNjc0MjE1Nw
```

Copy the last segment (after the `/`) from the endpoint. This is technically
what OBS calls the "Stream Key". Paste it into **Stream Key** input, then delete
it from the **Server** input, along with the final `/`.

Once done, your Stream config should look something like this:

<img src="https://mintcdn.com/hopio/cq2ctXa-N8Jv0svA/images/obs-stream-2.webp?fit=max&auto=format&n=cq2ctXa-N8Jv0svA&q=85&s=b52703b6d08b89b864ceb2a22a91084a" alt="" width="1436" height="288" data-path="images/obs-stream-2.webp" />

Click **OK**.

You can now hit the **Start Streaming** button. You're now streaming to Pipe!

## Advanced Mode

> This how-to guide is not complete. Please ask in
> [our Discord](https://discord.gg/hop) if you have any questions.

Before we get started, make sure you obtain a Project Token with "Manage Pipe"
permissions from the Console and use it to initialize the Hop SDK.

[How to Create Project Tokens](./tokens#creating-project-tokens)