How it worksPricingChurchOBS PluginDocsResources

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. The zip contains the native beam-obs.plugin bundle, a sample configuration, and the install guide.

    Verify download integrity

    SHA-256 checksum for beam-obs-plugin-darwin-arm64.zip:

    c7cafc75719ae3bd8557a41341c2a75335ac8ee69bb6e5602115e5422e050b9f  beam-obs-plugin-darwin-arm64.zip

    Verify on macOS:

    shasum -a 256 beam-obs-plugin-darwin-arm64.zip

    Verify on Linux or WSL:

    sha256sum beam-obs-plugin-darwin-arm64.zip

    The output should match the checksum above. If it does not, do not run the plugin — re-download and try again.

  2. 2

    Install the native plugin

    Quit OBS completely, then copy beam-obs.plugin into~/Library/Application Support/obs-studio/plugins/. Create the plugins folder if it does not exist.

    Unsigned beta: after opening OBS once, macOS may block the plugin. OpenSystem Settings → Privacy & Security, click Allow Anyway, then restart OBS.
  3. 3

    Configure your Beam account

    Copy obs-plugin.sample.json to~/Library/Application Support/Beam/obs-plugin.json, then set these values:

    • stream_id— 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.
    • runtime_mode— set to full to enable real uploads.
  4. 4

    Go live as normal

    Click Start Streaming in OBS like you always do. The Beam dock will appear in OBS and turn green when segments are connected and uploading. Beam automatically buffers your stream and delivers it to all attached RTMP destinations.

    When you click Stop Streaming, the plugin finishes its in-flight work and shuts down cleanly.

Troubleshooting

Status shows "Offline" after starting the stream
Confirm runtime_mode is set tofull, and verify the Stream ID and API key in the config file.
The Beam dock does not appear
Confirm the bundle is in the exact OBS plugins folder, complete the one-time macOS approval above, and relaunch OBS. The current beta requires Apple Silicon and OBS 32.1+.
Stream uploads but nothing appears on YouTube
In the dashboard, make sure your stream has RTMP destinations attached and that you have clickedGo 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