Streaming & recording
Streaming
Choose a video engine, connect Facebook Live, YouTube, or a custom RTMP destination, and go live.
On this page
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.
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.
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.
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