KERYXUser guide
⌘K
DownloadOpen KERYX

Getting started

  • Welcome to KERYX
  • Install and update KERYX
  • Running a service, step by step
  • Your first Sunday with KERYX

Planning on the web

  • Planning on the web
  • Planning Center

Running the service

  • Services
  • Songs
  • Scripture
  • Media
  • Presenting
  • Companion

Streaming & recording

  • Audio & camera
  • Streaming
  • Recording
  • Publishing

Reference

  • Settings reference
  • Keyboard shortcuts
  • Troubleshooting

Streaming & recording

Streaming

Choose a video engine, connect Facebook Live, YouTube, or a custom RTMP destination, and go live.

On this page
  • Choosing a video engine
  • Setting up a destination
  • Quality settings
  • Starting and stopping
  • Status indicators
  • What happens when the connection drops
  • Graphics on the stream
  • Related pages

This page covers setting up where your stream goes, how good it looks, and how to start and stop it — plus what KERYX does automatically when a connection drops mid-service.

#Choosing a video engine

Settings → General → Video engine

Option What it is When to use it
Standard The FFmpeg-based capture and encode path KERYX has used since it shipped If you'd rather stay on the original, proven path
OBS engine (beta) A libobs-based engine running as its own process Default for new installs. Needed for 4K recording, and gives you OBS's own reconnect handling for the stream

Changing this setting only takes effect once both streaming and recording are fully stopped — you can't switch engines mid-service.

With the OBS engine, a dropped stream connection reconnects on its own; if the engine itself stops, KERYX restarts it after a short wait. A missing camera or mixer doesn't stop the service either way — slides and whatever inputs do exist keep recording and streaming.

Note: 4K recording requires the OBS engine — the Standard engine tops out at 1080p for recording. See Recording.

#Setting up a destination

Settings → Streaming → Destination

Setting What it does
Platform Facebook Live, YouTube, or Custom RTMP
Server URL The RTMP(S) ingest address for your platform
Stream key The private key that ties your stream to your account/channel

#Facebook Live

In Facebook's Live Producer (or the Live tool on your church Page), look for the streaming setup screen — it gives you a Server URL and a Stream key. Copy both into KERYX's Server URL and Stream key fields. Facebook's default ingest address looks like rtmps://live-api-s.facebook.com:443/rtmp/.

#YouTube

In YouTube Studio, go to Go Live and open the stream key page. Copy the Stream URL and Stream key shown there into the matching fields in KERYX.

Note: This is separate from the YouTube connection under Settings → Publishing, which is for uploading trimmed sermon recordings after the service, not for live streaming. See Publishing.

#Custom RTMP

Choose Custom RTMP and enter whatever Server URL and Stream key your provider gives you — this covers any RTMP(S)-compatible destination that isn't Facebook or YouTube.

Warning: Treat the stream key like a password. Anyone with it can push their own video to your channel. KERYX stores it locally and shows it masked; use the show/hide toggle next to the field only when you need to check it.

#Quality settings

Settings → Streaming → Quality

Setting What it does Recommended
Resolution Output video resolution 720p for most connections; 1080p if your upload bandwidth supports it
Video bitrate kbps for the video stream ~3800 kbps at 720p is a proven starting point
Frame rate fps 30

#Advanced

Settings → Streaming → Advanced

Setting What it does Recommended
Encoder Software (x264) or Apple hardware Software (x264) for reliability; Apple hardware if your Mac is under load
Keyframe interval Seconds between keyframes 2
Audio bitrate kbps for the audio stream 160
Audio sample rate 44.1 kHz or 48 kHz 48 kHz
Audio delay ms offset to line audio up with video 0, adjusted only if you notice lip sync drift

If the stream's audio and video look out of sync, nudge Audio delay up or down in small steps and recheck — a positive value delays the audio, a negative value delays it less relative to video. See Audio & camera for gain and level settings, which live on a separate settings pane.

#Starting and stopping

The stream and the recording are independent, manual controls. Nothing starts either one for you, so start each with its own button.

  • Click Start Stream to begin pushing to your configured destination. The button turns into Stop Stream while live.
  • Click Start Preview first if you want to check the camera framing before going live — this runs the camera and composited output without actually streaming. If you skip it, the preview starts automatically the moment you click Start Stream.
  • Click Stop Stream to end the broadcast. This does not stop the recording if one is running — they're controlled separately.

#Status indicators

Next to the stream controls, a status chip shows the current state:

Status Meaning
Connecting KERYX is establishing the connection to your platform
Live Actively streaming; shows current fps and bitrate
Reconnecting The connection dropped and KERYX is retrying automatically
Stream error Something failed before or during the attempt — check Settings → Streaming

On the Stream Preview panel itself, a pulsing red outline and a LIVE badge appear whenever you're on air (streaming, recording, or both) — the badge reads REC instead of LIVE when you're recording only, not streaming.

#What happens when the connection drops

If your internet connection to the streaming platform drops mid-service, KERYX doesn't give up immediately — it retries automatically, showing Reconnecting in the status chip, and backs off between attempts so it isn't hammering a connection that isn't coming back right away. It keeps trying until you click Stop Stream yourself. Recording, if it's running, is unaffected by a streaming disconnect — it's a completely separate leg and is never auto-restarted if it fails for its own reasons.

#Graphics on the stream

Stream layout (the row of buttons below the Stream Preview panel) controls what appears composited into the outgoing video, separate from what the projector in the room shows:

Layout What it shows
Auto Follows the current slide/scene automatically
Full Full-screen slides
Lower third A lower-third graphic over the camera
Overlay An overlay graphic
PIP Picture-in-picture
Camera Camera only, no graphics

This lets you put lyrics or a lower third on the stream while the room's projector keeps showing whatever the operator has on the main output.

#Related pages

  • Audio & camera — mixer, camera, and gain setup
  • Recording — local recording settings, separate from streaming
  • Presenting — running slides and scenes during the live service
  • Publishing — sending a trimmed sermon to YouTube and the podcast feed after the service
PreviousAudio & cameraNextRecording

On this page

  • Choosing a video engine
  • Setting up a destination
  • Quality settings
  • Starting and stopping
  • Status indicators
  • What happens when the connection drops
  • Graphics on the stream
  • Related pages