Everything the booth needs, explained.

Install

Install Kerygma on the church media computer and complete the first setup before Sunday.

# macOS
Download: https://kerygma.dev/api/download/macos

# Windows
Download: https://kerygma.dev/api/download/windows

1. 1
   Install the app.

   On macOS, open the DMG and drag Kerygma to Applications. On Windows, run the installer and follow the prompts.

2. 2
   Allow the first-run model setup to finish.

   Keep the app open and connected until it reports that the local speech components are ready.

3. 3
   Rehearse with the real booth setup.

   Use the same laptop, audio input, and output path planned for service.

If your computer says it can’t open Kerygma

First confirm that the installer came from kerygma.dev, then use the platform’s one-time approval flow.

On macOS

1. 1
   Try to open Kerygma once, then close the warning.
2. 2
   Open System Settings → Privacy & Security.
3. 3
   Find the blocked-app message and click Open Anyway.
4. 4
   Confirm with your password or Touch ID, then click Open.

# Clear the download quarantine flag
xattr -cr /Applications/Kerygma.app

On Windows

1. 1
   In the SmartScreen warning, click More info.
2. 2
   Click Run anyway, then continue the installer.

Sign in

Sign in for account-backed and cloud features. The local workflow can be used without an account.

1. 1
   Click Sign in in Kerygma. A fresh browser tab opens.
2. 2
   Finish signing in on kerygma.dev, then return to the still-open app.

Run your first test session

Prove the mic → transcript → detection → output chain out loud before service.

1. 1
   Choose the microphone or mixer input that carries the preacher.
2. 2
   Click Start Session and read “John 3:16” clearly.
3. 3
   Confirm that speech appears in Live Transcript and the verse appears in Detections.
4. 4
   Click the detection to stage it, check it, then press Ctrl / Cmd + Enter.
5. 5
   Confirm the external display or stream shows the same content as Live Output.

Choose the right microphone

Clean, close speech matters more than an expensive microphone across the room.

Connect audio from a church mixer

Use a spare line-level output or the mixer’s USB interface—not a powered speaker output.

Good mixer outputs

• USB audio: simplest when the mixer exposes its channels or main mix to the computer.
• Aux or matrix: best for a speech-heavy feed with music reduced.
• Record out: usable if the level is clean and controlled.

How to connect it

1. 1
   Connect mixer USB directly, or connect a line output to a USB audio interface.
2. 2
   Select that mixer/interface under Settings → Audio.
3. 3
   Start low and raise the send until speech is steady without red clipping.

Computer performance

Offline transcription uses local compute; online transcription needs a stable connection.

• Plug the laptop into power and disable sleep during a service.
• Close video editors, games, unused browsers, and unnecessary OBS previews.
• Test the selected offline model on the actual laptop before relying on it.
• If local transcription cannot keep up, use the online engine when your account and connection allow it.

The operator screen, part by part

The Scripture and Songs buttons change the source workspace while Stage Preview, Live Output, and the action bar stay familiar.

Show verses during a sermon

1. 1
   Choose Scripture and start the session.
2. 2
   Click a detection, or use Ctrl / Cmd + F to search manually.
3. 3
   Check the translation, reference, verse text, and slide count in Stage Preview.
4. 4
   Press Ctrl / Cmd + Enter to send it live.
5. 5
   Press Space or B to blank the output when needed.

Use Left and Right to move through the active verse’s slides, then adjacent verses.

Meet AI Operator

AI Operator is Kerygma’s opt-in Scripture automation assistant. It follows the passage already on screen, prepares what is likely to come next, and can advance Live Output when the evidence is strong.

1. 1
   Choose Scripture and start a session.

   AI Operator applies to the Scripture workspace. Songs has its own separate Auto-follow control.

2. 2
   Put the first verse on screen.

   An explicit first reference can establish the live passage; you can also stage and send the opening verse manually.

3. 3
   Turn on AI Operator beta in the top bar.

   The current beta grants sequential automation: it follows the active passage and prepares or advances the next verse as the preacher continues.

4. 4
   Watch Stage Preview and Live Output.

   Likely next content can be staged on deck. A live advance requires supporting speech evidence and must pass the anti-flicker dwell guard.

5. 5
   Turn it off at any time.

   Off restores the normal manual workflow immediately.

What the beta will and will not automate

• It can: follow reading progress, move forward through long multi-slide passages, and advance within the current passage when the next verse is strongly supported.
• It holds: ambiguous matches, repeated content, out-of-range references, and changes attempted before the current content has remained live long enough.
• It does not promote a passive quote by itself: parallel Bible passages can share the same wording, so uncertain quote matches remain suggestions.
• It starts off: a fresh app launch defaults to manual operation until the operator enables the beta.

Run worship in Song Mode

Songs is a complete live-lyrics workspace inside the main operator window, not a separate presentation path.

1. 1
   Click Songs in the top mode switch.

   The Song Library replaces Live Transcript. Stage Preview, Live Output, and the action bar remain shared.

2. 2
   Search for and select a song.

   Its sections and play order appear in the right-hand teleprompter.

3. 3
   Tap the required section in the right teleprompter.

   The section is staged and sent live immediately, and the live section is highlighted.

4. 4
   Follow the service order manually.

   Tap Verse, Chorus, Bridge, or Tag as the worship team moves through the song.

5. 5
   Choose a background.

   Click a tile in the Songs media strip. It goes live behind the lyrics and is remembered for that song.

Listening, suggestions, and Auto-follow

• The listening band shows the recent words Kerygma hears from the singers.
• With Auto-follow off, a recognised library song appears as a suggestion. Click Load or dismiss it.
• With Auto-follow on, Kerygma can recognise a song section, stage it, and send it live automatically. The match and confidence appear in the band and can be dismissed.

Add and import songs

Use the + button beside Song Library to create one song or import an existing file.

Create a song

1. 1
   Switch to Songs, click +, then choose New song.
2. 2
   Enter the title, authors, optional CCLI number, and lyrics.
3. 3
   Use section headers such as [Verse 1], [Chorus], [Bridge], and [Tag].

   The section pills insert headers, and Auto-structure can split pasted stanzas and detect a repeated chorus.

4. 4
   Optionally search online by song name and load a result, then review or correct the lyrics.
5. 5
   Check the live preview and click Save to library.

Import from another app or file

1. 1
   Click + beside Song Library and choose Import from file….
2. 2
   Select the file. Single-song formats open in the editor so you can review them before saving.
3. 3
   Search the library by title, author, or lyric text to confirm the import.

Theme Studio—make it look like your church

Open Output → Themes… to design the presentation style used by scripture and song lyrics.

1. 1
   Choose or create a presentation theme.
2. 2
   Set typography, colours, alignment, reference treatment, shadows, and background.
3. 3
   Preview at the same aspect ratio used by the projector or stream.
4. 4
   Save, then send a test verse and song section before service.

Sunday workflow

Before service

• Connect power, mixer input, projector/capture, and network.
• Start a test session and confirm the transcript moves.
• Send one verse and one song section to every live output.
• Confirm the worship songs, section order, and backgrounds are in the library.

During worship

• Switch to Songs, load the current song, and use the section teleprompter.
• Keep Auto-follow off for manual operation, or monitor its confidence closely if rehearsed and enabled.

During the sermon

• Switch to Scripture and check every detection in Stage Preview.
• Use search for a verse Kerygma did not detect.
• Blank the output when the pastor moves on.

After service

• End the session, save or export what the team needs, then close the output window.

Every menu, explained

Settings, explained

Outputs & streaming

Live Display

Choose the output display, open the live window on it, and decide whether Send to Live needs a confirmation.

Streaming & broadcast

• Projector window: turn it off if another presentation app owns the second monitor.
• NDI broadcast: publishes the configured source name to compatible receivers.
• OBS browser overlay: use the local or LAN URL in an OBS Browser source.
• Motion Backgrounds: import MP4/MOV files, then select or clear a looping background.

Keyboard shortcuts

These match the current desktop bindings. Use Ctrl on Windows/Linux and Cmd on macOS for the letter shortcuts.

Account & billing

Use Account to view your plan and open the billing portal. If a plan change does not appear in the app, let it refresh, then sign out and back in.

Updates

Use the Download page for the latest published build. Install required updates and repeat the output/audio test before the next service.

Troubleshooting

Open the symptom that matches what the operator sees.

FAQ