OBS integration

Set up Beam Networks Stream in OBS.

The Beam plugin lives inside OBS — no separate app, no terminal commands. You fill in two fields, click Start Streaming, and Beam handles the rest: buffering, gap recovery, and delivery to YouTube or any RTMP destination.

Before you start

  1. 1

    Download the plugin

    Download the latest beam-obs-plugin.zip from the releases page. The zip contains the plugin script and the Beam agent binary. Unzip it anywhere — your Downloads folder is fine.

  2. 2

    Add the script to OBS

    Open OBS and go to Tools → Scripts. Click the + button and navigate to the unzipped folder. Select beam_obs_script.py and click Open.

    macOS only: OBS requires Python 3.10 or later to run scripts. If you see a warning, download Python from python.org and point OBS to it under Tools → Scripts → Python Settings.
  3. 3

    Enter your stream key and API key

    With the script selected in the Scripts window you will see the Beam panel on the right. Fill in two fields:

    • Stream Key — copy this from the dashboard on your stream's detail page (the "Copy stream ID" button).
    • API Key — found under API Keys in the dashboard sidebar. Create one if you haven't already.
  4. 4

    Go live as normal

    Click Start Streaming in OBS like you always do. The Beam status indicator in the script panel will turn green when the agent is connected and uploading. Beam automatically buffers your stream and delivers it to all attached RTMP destinations.

    When you click Stop Streaming, the agent finishes uploading any remaining segments and shuts down cleanly.

Troubleshooting

Status shows "Offline" after starting the stream
Make sure the agent binary (beam-agent) is in the same folder as the script, or set the Agent Path field in the script panel to point to it. On macOS you may need to right-click the binary and choose Open the first time to allow it past Gatekeeper.
OBS says "Failed to load script"
Go to Tools → Scripts → Python Settings and verify that OBS is pointing to a Python 3.10+ installation. The script does not require any third-party Python packages.
Stream uploads but nothing appears on YouTube
In the dashboard, make sure your stream has RTMP destinations attached and that you have clicked Go Live on the stream detail page. The reassembly buffer holds ~90 seconds before delivering to destinations.
Still stuck?
Open a support ticket from inside the dashboard (the help icon in the bottom corner) and include the OBS log file (Help → Log Files → View Current Log).

Don't have an account yet?

Get started free