How it works Pricing Church Docs Resources

Docs

OBS setup

Beam Networks Stream expects OBS to record locally as small HLS chunks. The agent watches that directory and uploads each segment to the cloud.

1. Create the output folder

mkdir -p /tmp/obs-hls

2. Switch OBS to Advanced output mode

  1. 1. Open OBS Settings.
  2. 2. Open the Output section.
  3. 3. Change Output Mode from Simple to Advanced.

3. Configure the Recording tab

  1. 1. Set Type to Custom Output (FFmpeg).
  2. 2. Set FFmpeg Output Type to Output to File.
  3. 3. Set the file path to /tmp/obs-hls/stream.m3u8.
  4. 4. Set Container Format to hls.
  5. 5. Set Video Encoder to h264_videotoolbox on Mac or libx264 on Windows/Linux.
  6. 6. Set Audio Encoder to aac.

hls_time=2 hls_list_size=10 hls_flags=delete_segments+append_list

4. Match the keyframe interval

The keyframe interval must match the 2-second segment length.

  • At 30fps, use keyint=60.
  • At 60fps, use keyint=120.

5. Test the output

  1. 1. Click Start Recording in OBS, not Start Streaming.
  2. 2. Check /tmp/obs-hls for a manifest and numbered .ts files.
  3. 3. Confirm a new segment appears roughly every 2 seconds.

Quick troubleshooting

  • If no files appear, make sure you started recording rather than streaming.
  • If h264_videotoolbox fails, switch to libx264.
  • If files appear but the agent skips them as empty, try removing delete_segments from the muxer settings and test again.