# OBS Studio

The easiest way to use Telestripe with your stream or production is with OBS (Open Broadcaster Software) - a free, open-source, and cross-platform streaming app.

Getting started is a simple process:

1. Send your video feed from OBS to Telestripe to act as your background video.
2. Send your telestrations back to OBS to overlay on top of your production video.

***

## 1. Installation

Please read the [disclaimer](#disclaimer) at the bottom of this page before continuing.

<details>

<summary>Windows</summary>

OBS Studio

1. Download OBS Studio from <https://obsproject.com/download#windows> and click on the 'Download Installer' option.
2. Run the OBS Studio installer (e.g., OBS-Studio-XX.X.X-Windows-Installer.exe).
3. Follow the instructions in the installation wizard to complete the installation.

Distro AV (NDI Plugin for OBS)

1. Visit <https://github.com/DistroAV/DistroAV/releases/latest> for the latest release of DistroAV.
2. In the latest release, under the 'Assets' section, select *distroav-X.X.X-windows-x64-Installer.exe* to download the installer.
3. Run the Distro AV installer
   1. You may encounter a Microsoft Defender Smartscreen popup. If you would like to proceed, select 'More info' and click 'Run anyway'
   2. Follow the instructions in the installation wizard to complete the installation.

NDI Runtime

1. The NDI runtime is available if you use NDI Tools or the NDI SDK. If you have these installed, skip the NDI Runtime installation steps.
   1. NDI Tools: <https://ndi.video/tools/>
   2. NDI SDK: <https://ndi.video/download-ndi-sdk/>
2. Download the NDI Runtime from <http://ndi.link/NDIRedistV6>
3. Run the installer: *NDI 6 Runtime.exe* and follow the instructions in the installation wizard to complete the installation.

</details>

<details>

<summary><strong>macOS</strong></summary>

OBS Studio

1. Download OBS Studio from <https://obsproject.com/download> and click on the 'Download Installer' option corresponding to your CPU type (Intel or Apple Silicon).
2. Double click the OBS Studio Disk Image (e.g., obs-studio-XX.X.X-macos-apple.dmg).
3. Drag the OBS Studio application into your applications folder.

Distro AV (NDI Plugin for OBS)

1. Visit <https://github.com/DistroAV/DistroAV/releases/latest> for the latest release of DistroAV
2. In the latest release, under the 'Assets' section, select distroav-X.X.X-macos-universal.pkg to download the package.
3. Run the Distro AV package.
   1. You may encounter a warning from macOS that the package is not signed or trusted. If you would like to proceed, open System Settings -> Privacy & Security, and allow the package to be installed.

NDI Runtime

1. Download the NDI Runtime from <http://ndi.link/NDIRedistV6Apple>
2. Run the *libNDI\_for\_Mac.pkg*
   1. You may encounter a warning from macOS that the package is not signed or trusted. If you would like to proceed, open System Settings -> Privacy & Security, and allow the package to be installed.

</details>

<details>

<summary><strong>Linux</strong></summary>

Follow the instructions at <https://github.com/DistroAV/DistroAV/wiki/1.-Installation#linux>

Installation instrucitons and methods may depend on your distribution.

</details>

You should now be able to open OBS Studio with NDI enabled.

***

## 2. Output Video from OBS

In order to send your clean production video without telestration feedback, you will need to create a dedicated NDI scene.

{% tabs %}
{% tab title="Step 1" %}

<div data-full-width="true"><figure><img src="/files/hvzaxh8xhm1ubdFOlaRg" alt=""><figcaption></figcaption></figure></div>

a. Create a **new scene** called “***Dedicated NDI Output***” (for example). This will to send the original feed into the Telestripe app.

b. Open the **Scenes’s Filters** by either right-clicking the scene or clicking the Filter icon at the bottom.
{% endtab %}

{% tab title="Step 2" %}

<figure><img src="/files/O4dds3UlVhzmrMQtTvoX" alt=""><figcaption></figcaption></figure>

In the Filters popup window, **(1)** create a New Filter by clicking the plus (+) icon, **(2)** then select “*Dedicated NDI Output*“. **(3)** Apply changes
{% endtab %}

{% tab title="Step 3" %}

<figure><img src="/files/Lch72pJQiCPiVcf9VBz1" alt=""><figcaption></figcaption></figure>

In your new Dedicated scene, you will add your existing video source (the same that is in your Main Scene), or any video source you would like to see as your drawing background in Telestripe.
{% endtab %}
{% endtabs %}

## 3. Select Input source in Telestripe

In the Telestripe App, open the Settings menu (hamburger menu in the top left), then click the **Video** tab. Under the 'INPUT' panel, you should see your OBS Dedicated NDI Output. **Click your OBS source to select it.** (Note: It will turn yellow once selected)

Make sure your **NDI input is enabled** by cicking the toggle in the top right of the 'INPUT' panel.

<figure><img src="/files/eoXCvzBo1Jb4FiI3D32M" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
If you don’t see your OBS output, you can try refreshing the sources with the 'refresh' button in the top right.
{% endhint %}

## 4. Output Telestrations from Telestripe

From the same **Video** tab in Settings, click the toggle on the header of the 'OUTPUT' panel (see image below). This will enable the output and create an NDI source of your telestrations on your network.

By default, a random number is generated for your NDI output name, but you can change it in the input box in this panel. You can also change the resolution and FPS as well.

<figure><img src="/files/q2J9PIdWypgy7Ug6VWoo" alt="" width="557"><figcaption></figcaption></figure>

## 5. Input Telestrations into OBS

In OBS, in your Main Scene, click the plus (**+**) button at the bottom of the Sources section. Select **NDI™ Source**. A popup should open.

Under **Source Name**, select the drop down, then select the NDI name you chose when setting up your NDI Output in the Telestripe app. Click OK.

<figure><img src="/files/p7Ogrqh1lQ1b9Tyw9Qd9" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Make sure your NDI input is above your main video source.
{% endhint %}

## Disclaimer

{% hint style="info" %}
Stripe Studios Inc. is not responsible for any third party software recommended in this documentation. OBS Studio, Distro AV, and NDI software are subject to their respective licences.

Please verify software before installing, and ensure their licences are respected.
{% endhint %}


---

# 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.telestripe.com/workflows/obs-studio.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.