Service program for worship · WorshipFlow

What the room needs
to see, on one screenScripture · Study · Hymns · Media · Output

One window holds scripture text and verses, the study pane, cross-references, hymns, and media — and sends the same content straight to OBS. Tablets join by QR code, and the output opens as a browser source.

  • Every screen and clip on this page was captured from the program while it was actually running.
  • These are not staged mockups — the frames are the same action, controller on the left, real OBS output on the right.
WorshipFlow controller screen: verse search, passage and parallel text, hymns, tablet connection and OBS connection in one window.
Controller screen — scripture, hymns, tablet and OBS handled from one place.
Program

Three surfaces

The window the operator drives, the tablet the congregation sees, and the output that reaches the room. The output opens as an OBS browser source, so there is no extra window to manage.

Full controller screen with top toolbar, passage pane, parallel text and hymn area.

Controller screen

Verse search and passage selection, study mode, cross-references, hymns, tablet and OBS connection — all in one screen. What you change here is what the output shows.

SearchPassage / parallelHymnsOBS connection
Tablet screen with a large QR code and connection address.

Tablet screen

The tablet shows a QR code and the address, so anyone can join. Connected tablets share the same state, so a change made in one place follows everywhere.

QR joinShared state
Output screen with scripture text and the verse shown on the projection display.

Output screen (viewer)

It opens as a full screen, as left and right browser sources, or as a KJV-only display — pick the shape that matches the room. Splitting left and right means adding two browser sources side by side.

Full screenLeft / right sourcesKJV only
Walkthroughs

One action reaches the output

Controller on the left, the same moment in real OBS output on the right, recorded side by side. Clips start muted.

Passage and verse

Type book, chapter and verse, send the passage, then choose which verse stays on screen.

  1. Enter book and reference
  2. Choose the output
  3. Confirm on the projection

Hymns

Open a hymn by number and step through the order with next and previous.

  1. Pick a number from the grid
  2. Send lyrics to the output
  3. Advance through the service order

Media

Drop an image or a video into the media pane and it appears on the output immediately.

  1. Drop the file into the media pane
  2. Step through the list
  3. Check it in real OBS output

Study mode

Study mode adds a reference pane beside the passage, and you can switch it between one column and two to fit the screen.

  1. Enter study mode
  2. Reference 1 column ↔ 2 columns
  3. Show a second translation together
Screen by screen

What each screen does

Not descriptions of features — the actual screen with the feature turned on.

Passage and verse

Enter book, chapter and verse to bring up the passage, then choose the verse to keep on screen. The output shows the passage with the verse laid over it.

  • Look up a passage by book and reference
  • Pick a verse and show parallel text
  • Move to the next verse from the results
Output screen with passage and verse shown together.
Output screen — the verse sits over the passage.

Study mode — reference 1 or 2 columns

Study mode attaches a reference pane beside the passage. Switch the reference between one column and two to match the screen, and bring up a second translation alongside.

  • Reference pane 1 column / 2 columns
  • Show another translation together
  • Output control pauses briefly in study mode
Study mode with passage and reference side by side in two columns.
Reference, 2 columns
Study mode with the reference pane narrowed to a single column.
Reference, 1 column
Study mode with a second translation shown.
Second translation

Adding and changing translations

The passage and the reference each pick their own translation. With the reference split into two columns in study mode, the top and bottom panes keep separate translations, so the same verse can sit side by side in two of them.

  • Built in: Majesty, King James Korean, Korean Revised Version, KJV
  • Chosen separately for the passage, the top reference and the bottom reference
  • + add bible file opens the folder where Bible files are kept
  • Each time the folder is read, files are detected and added to the list with their own name and details
  • With sync translations on, the chapter and verse you focus in the passage follow into both reference panes
Study mode with two reference columns: the passage in the Korean Revised Version, the top reference in King James Korean, the bottom reference in Majesty.
Passage: Korean Revised Version · top reference: King James Korean · bottom reference: Majesty — three different translations at once.

Cross-references

Tap a cross-reference in the passage and it moves straight into the reference pane. Each tap changes the reference, so you can follow a related text live during the service.

  • Tap a cross-reference → the reference pane takes that verse
  • The reference pane is sent with the passage
  • Keep moving to other chapters
Controller screen with a cross-reference applied to the reference pane.
Tapping a cross-reference changes the reference pane at once.

Sermon notes

Keep the lines you need in a separate pane and send them to the screen one at a time as the message moves along.

  • Collect sermon lines separately
  • Send the line you are on
  • Turn auto-advance on or off
Controller screen with the sermon notes pane open.
Sermon notes pane

Hymns

Type a hymn number and the lyrics come up. Next and previous sit next to the number so the order keeps moving through the service.

  • Type a number or pick from the grid
  • Next / previous hymn
  • Lyrics go to the output as they are
Controller screen with a grid of hymn numbers.
Hymn number grid

KJV toggle

A button on the controller turns KJV on and off. It shows in the full-screen output too, and there is a separate address for a KJV-only display when you want just that.

  • One button turns the KJV display on and off
  • Reflected in the full-screen output
  • A KJV-only browser source address is provided
Controller screen with the KJV display turned on.
Controller screen with KJV on

Verse cards and background opacity

The verse card is a countdown card you put on screen. Background opacity steps from 0% to 100% in five steps — 50% lays the verse over a camera feed, and 0% leaves only the countdown.

  • Background opacity 0 · 25 · 50 · 75 · 100%
  • 50% mode: the verse sits over the camera image
  • Main and reference cards are set separately
  • Card size and display time are adjustable
Verse card settings dialog with background opacity options, card size and display time.
Card settings — background opacity 0 to 100%
Main verse card set to 50% background opacity.
Main card at 50%
Reference verse card set to 50% background opacity.
Reference card at 50%
Main verse card with the default background.
Main card, default background
Reference verse card with the default background.
Reference card, default background

Media in one drop

Drop a file into the media pane and it is registered immediately — the image and the video both show up in the output. These two frames are captured from real OBS output.

  • Drop or open an image or video file
  • It appears in the output right away
  • Step through the list with next / previous
A registered image appearing in real OBS output.
Real OBS output — image
A registered video playing in real OBS output.
Real OBS output — video
OBS connection

Two ways, depending on what you need

A browser source simply shows the screen. A websocket lets the program drive OBS itself. The addresses and steps below were tested against a running OBS.

Open the screens as browser sources

Add a browser source in OBS and paste the address. The program must be running for the screen to update.

Full screen
Passage and verse on one large screen. /viewer
Left browser source
The window carrying passage and verse. /viewer?profile=obs-card&panel=main
Right browser source
The window carrying reference and parallel text. /viewer?profile=obs-card&panel=parallel
KJV only
When you want KJV on its own. /viewer?profile=kjv-only&kjvOnly=1&panel=main

These addresses point at the PC running the program. If OBS runs on a different machine, open the same address from that machine.

Left and right browser source panes, with the passage and the verse side by side.
Left and right browser source panes — the two addresses side by side.

Let the program drive OBS over a websocket

When the program needs to move OBS itself — switching scenes, for example — use the websocket. Turn on obs-websocket in OBS and enter the port and password in the program; it reports whether the connection succeeded.

  • Enable obs-websocket in OBS (default port 4455)
  • Enter the port and password in the connection dialog
  • Install the basic scenes in one step
  • Check the connection state on the controller

Tested on Windows with OBS 32.2.2 (obs-websocket 5.7.4). Installing basic scenes only works on the machine running OBS.

A real OBS window connected over websocket showing the full-screen scene.
Real OBS window, connected over websocket
FAQ
What does it take to run?

The program has to be running on the PC that drives the service, and the output goes to OBS on that machine. The setup used for these captures was a Windows PC with OBS Studio (obs-websocket 5.7.4).

What is the difference between a browser source and a websocket?

A browser source just shows the screen. A websocket lets the program drive OBS itself. If you only need the screens, browser sources are enough; a websocket is for when the program also has to move OBS, such as switching scenes.

How do I get the left and right screens?

Add two browser sources and place them side by side. Passage and verse go to /viewer?profile=obs-card&panel=main, reference and parallel text to /viewer?profile=obs-card&panel=parallel. If you want everything in one frame, use /viewer.

How do I put a verse over the camera feed?

Set the verse card's background opacity to 50%. The verse then sits over the camera image; at 0% only the countdown remains. 25%, 75% and 100% are available too.

Is there an automatic projector output?

There is, but it needs a monitor with the configured name to exist on the PC. The machine used for these captures did not have one, so we have not seen it open. We will describe it once we have watched it run into a projector.

Can I show KJV on its own?

The full-screen output has a KJV toggle, and there is a separate browser source address for a KJV-only display. KJV is long-worded, so it is worth checking the text size against your screen width.

Next

What we are building

None of this works yet, so there are no screens to show. As it does, the real captures will go on this page the same way.

  • Keeping a record of the passages and verses preached, and bringing them back up
  • Looking back over those records while preparing the next message
  • Trying it in real services first to see which form is actually useful
Contact

Tell us the scene you need

Describe which service, in what order, and what has to be on screen — we will set up that sequence and show it to you.

▶Walkthroughs +Bible reading