Settings - Bible App

Tab Visibility

Control which tabs are visible in the main app window. Uncheck tabs you don't want to see during presentations. Changes take effect immediately when you return to the app.

✓ Saves automatically

Service Profiles

Save a named preset for each service type (Sunday, Together Tuesday, First Tuesday…). A profile bundles your visible tabs, default graphics/announcements/notes, Bible text size, and OSC settings, so you can switch your whole setup in one tap.

Loading…

New profile name

"Save current" captures the app's current tab visibility, default media, font size, and OSC settings. Applying a profile takes effect when you return to the app (OSC address/port changes need an app restart).

Bible Reading

Adjust the on-screen size of the scripture text. Takes effect when you return to the app.

Text size: 60px

✓ Saves automatically

Red Letter (Words of Christ)

Show the words of Christ in red

Colors Jesus' spoken words red in the Bible reader, using a bundled public-domain words-of-Jesus list. Only the quoted words within a verse are reddened. Takes effect when you return to the app.

Add or correct references

One per line, e.g. John 3:16 or Matthew 5:3-12. These are added to the built-in list.

✓ Saves automatically

Presentation

Toolbar

Drag the toolbar handle (top-right) out to turn it into a floating dock you can place anywhere your hand rests on stage (it dims when idle). Throw the dock to the top of the screen to dock it back to the rail. Use "Tools to show" below to hide tools you don't use.

Tools to show

Hide tools you don't use to keep the toolbar and dock uncluttered on camera. Applies to both. (A Menu button is always available in the dock so Settings stays reachable.)

Pen Highlighter Eraser Laser Spotlight Undo Redo Clear

Two-finger tool selector

Tap the passage with two fingers at once and the tools fan out around the tap; tap one and the selector is gone. It appears only where a tool can be used (not on the book / chapter pickers, images, Ask or Prayer), and any other touch, scroll or stroke puts it away.

Two-finger tap opens the tool selector

Shape Ring — the original. Five separate discs fanned out around the tap. Big and unmissable; takes about a third of the width of the screen while it is up. Slim dial — smaller and less in the way. One small dial cut into a segment per tool, with the close button in the middle. About two thirds the width and a third of the area, so much less of the passage is covered — and much less of it is on camera if the program feed catches the moment. Same gesture, same colours, same unfold.

Highlighter / eraser return to the pen after this many seconds

Seconds without a touch. 0 = a tool stays until it is changed (default). With a value, "what am I on?" is always "the pen" a few seconds after highlighting or erasing.

Transition when switching Graphics / Announcements slides. Off = instant (default). A crossfade looks smoother, but test it on the actual stage TV first — scroll a graphic and confirm there is no thin edge line before using it live.

Slide crossfade: Off

✓ Saves automatically

Updates

Install new versions from a folder you control — a network share, a USB drive, or a web address. No internet or app store needed. Current version: …

Update folder or address

That location needs the installer plus a small latest.json — the build script writes both for you.

Check for updates automatically when the app starts

✓ Saves automatically

The app closes while the installer runs, then reopens. Your notes, graphics, annotations and settings are kept.

Local AI model

The offline AI model (about 1.9 GB) ships inside the installer, so a new machine has working AI as soon as the app is installed — nothing extra to copy over. You only need the box below to point at a different model file by hand.

Checking…

Model file location (leave blank to use the update folder above)

Phone Remote

Control the app from your phone over the church Wi-Fi (the phone must be on the same network as this computer). Turn it on, set a PIN, then open the address below on your phone. Only people on your Wi-Fi who know the PIN can control the app.

Enable phone remote

PIN (4+ digits)

If it won't connect: confirm the phone is on the same Wi-Fi, and that Windows Firewall allows the app on port 8080.

Admin Console (offstage)

A private copy of the whole app, in your own browser, for fixing and updating things without any of it appearing on the TV. Navigate, prep tabs, upload content, change settings — the congregation sees none of it. When something is ready you push that one change to the TV; nothing else on the stage moves.

This uses its own PIN, separate from the phone remote above — so an operator with the remote PIN cannot reach the admin console.

Enable admin console

Admin PIN (4+ digits)

Content and settings changes save to this computer, so they reach the TV like any other edit. Tabs, passages and drawings in your private copy stay private until you push them.

ProPresenter Sync

The ProPresenter Sync tab follows whatever scripture slide is live in ProPresenter and opens that verse, the same way a tap on a verse card would. Enter the address of the ProPresenter computer (ProPresenter 7: Preferences → Network → Enable Network; the default port is 1025). On the tab itself nothing extra is shown — only a small dot: grey off, amber connecting, green live, red dropped.

Follow ProPresenter

IP address / host of the ProPresenter computer

Port

ProPresenter version

Reconnect every (ms)

Network password (stage display / Pro 6 only)

Also watch the Announcement layer

Annotations

By default the sync tab shares its marks with the Bible tabs: one chapter, one set of marks, wherever that chapter is open. Turn this on to give the sync tab a store of its own — then the same book and chapter can be open in a Bible tab and in the sync tab with different marks on each (teach on one, follow the slides on the other).

Sync tab keeps its own annotations, separate from the Bible tabs

Nothing is ever thrown away by this switch: each side's marks stay under their own store and come straight back when it is switched again. Takes effect when you return to the app.

Test uses the values in the form; nothing changes until Save. Slides are read label → notes → text, and the tab holds its last verse when a slide carries no scripture or the link drops. Turn the tab itself on or off under Tab Visibility.

Follower Screen

A second screen anywhere on the network shows exactly what this TV shows — the Bible text, graphics, announcements and live pen strokes — without any cable from this computer. Open the address below in a fullscreen browser on the machine that feeds ProPresenter (or the switcher). It follows this TV automatically.

Allow follower screens

Off = any connected follower screen goes black at once and nothing can connect.

Open this on the follower machine

Reading this computer's address…

Computed on this computer each time this page opens — every installation shows its own address. If several are listed, use the one on the same network as the follower machine (the .local name works on most Macs).

Translation Visibility

Control which Bible translations are shown in the main app picker. The current translations stay enabled by default; newly added English translations start disabled until you turn them on here.

✓ Saves automatically

OSC (Open Sound Control) Configuration

Configure OSC settings for remote control of the Bible App. OSC commands allow external devices (like Bitfocus Companion) to control the app via UDP messages.

Status

Loading...

Listen Address

IP address to listen on. Use 127.0.0.1 for localhost only, or 0.0.0.0 for all interfaces.

Listen Port

UDP port number for OSC messages (default: 3333).

Allowed IP Addresses

Specific IP addresses allowed to send OSC commands. Leave empty to allow all (when bound to loopback).

Allowed IP Prefixes

IP address prefixes allowed to send OSC commands (e.g., "10." for all 10.x.x.x addresses).

Security Token (Optional)

If set, OSC commands must include this token as an argument. Leave empty to disable token requirement.

Accordance OSC Port (Optional)

Port number for Accordance Bible Software OSC server (if using Accordance integration).

OSC Feedback Configuration

Configure OSC feedback settings for Companion integration. Feedback messages are sent back to confirm command execution.

Enable OSC Feedback

When enabled, the app will send OSC feedback messages after processing commands. Required for Companion button confirmation.

Feedback Address (Optional)

IP address to send feedback messages to. Leave empty to use the most recently detected OSC sender. For the most reliable Companion setup, set this to Companion's listener IP.

Feedback Port (Optional)

Port number to send OSC feedback messages to. For reliable Companion matching, use a fixed module feedback port (for example 18000). If left empty, the app uses the sender port when available, then the last known OSC sender port.

Information line — /bibleapp/feedback/information

One path, one short line, for the button you actually watch during a service. It answers the two things you cannot see from the booth: which tab he has moved to, and whether the splash is up over the top of it. Sent as a single OSC string whenever it changes.

Reads like 2/5 Bible | John 3 | LIVE or 4/5 Sync | Romans 8 | SPLASH. Tick what you want in it — pieces always appear in the order below, whatever order you tick them. Untick everything to switch the line off. All the older /feedback/state/… paths keep working.

Tab (2/5 Bible) Passage (John 3) Translation (ESV) Tool (Pen) Pen colour (#ffff00) Splash (LIVE / SPLASH) ProPresenter (PP LIVE)

Saved with the rest of this section by Save OSC Configuration below. In Companion, add one OSC listener on /bibleapp/feedback/information and put its first argument on the button.

Tab button colours

The information line above is words, which is right for button text. A Companion colour comes from a boolean feedback instead — 1 lights the button, 0 puts it out. This sends which tab is active that second way, so a button can go green the moment he moves to it.

/bibleapp/feedback/state/tab_active/<n> — 1 while the n-th tab on the row is showing (1–16).
/bibleapp/feedback/state/tab_kind/<kind> — 1 while a tab of that kind is showing:
bible · sync · whiteboard · notes · media · alpha · announcements · graphics · maps · prayer · ask

Send per-tab on/off states for Companion button colours

Use tab_active for a row of buttons that mirrors the tab bar, and tab_kind for a fixed button that asks “is he on the whiteboard?” — that one stays right however the tabs are reordered. Every slot and kind is re-sent on each change, so a button can never be left lit for a tab he has already left. Slots past the end of the row just stay dark.

OSC Diagnostics

Test OSC connectivity and check if commands are being received.

Splash Screen

The TV goes to the splash screen after it has been left alone for a while and comes back on the next touch. Set how long "a while" is here. The splash also comes up from the refresh button, the phone remote / Companion, and (if left on) a five-finger touch. The booth follower screen never shows a splash of its own — it only mirrors this TV.

Go to the splash after this many seconds without a touch

Default 60. 0 = never go to the splash on its own. Applies at once, no restart.

Five-finger touch shows the splash

Turn off if a resting hand keeps bringing the splash up.

Recent splash appearances on this TV

—

Every time the splash comes up, the app writes down when and why. If it ever appears unexpectedly, the reason is here.

Default Graphics

Control whether default graphics (splash.png, Notes.png, Announcements.png) are available in the app. When enabled, default graphics will be automatically restored if they don't exist. When disabled, these files will be hidden and deleted from your content directories.

Enable Default Graphics

When enabled, default graphics (splash.png, Notes.png, Announcements.png) are available and will be automatically restored if missing. When disabled, these files will be hidden and deleted from your content directories.

Word Popup Cards

Double-tap any word in a Bible passage to open its card — including the exact Hebrew or Greek word behind it in that verse. Choose below exactly what appears on the cards; Hebrew (OT) and Greek (NT) are customized separately. Changes apply to new popups immediately.

Enable word popup cards (double-tap a word)

✓ Saves automatically

Ask Tab (AI Assistant)

The Ask tab uses the built-in Local AI (Llama 3.2 3B, tuned for live speed) — fully offline, nothing to install. Answers are grounded in Scripture automatically. You can also add online API providers below, or point it at a separate Ollama install (advanced).

Ollama model (only if using a separate Ollama install)

Not used by the built-in Local AI. Examples: llama3.2, mistral, qwen2.5:3b

Active provider

Extra API providers (optional)

Add OpenAI, Anthropic, or any OpenAI-compatible endpoint. Keys are stored locally on this device only.

OSC Commands Reference

Available OSC command addresses (send to the configured address:port):

Core Actions:
/bibleapp/undo (or /undo) - Undo last action
/bibleapp/redo - Redo last undone action
/bibleapp/reset (or /reset) - Reset/reload the app
/bibleapp/clear - Clear current tab
/bibleapp/clear_all - Clear all tabs
/bibleapp/splash/show (or /splash/show) - Show splash screen
Tabs:
/bibleapp/new (or /bibleapp/new/tab) - Create new Bible tab
/bibleapp/new/whiteboard - Create new whiteboard tab
/bibleapp/new/notes - Create new notes tab
/bibleapp/close - Close active tab
/bibleapp/tab/left - Switch to previous tab
/bibleapp/tab/right - Switch to next tab
Tools:
/bibleapp/tool pen|highlight|erase|select - Switch tool
/bibleapp/tool/pen | /bibleapp/tool/highlight | /bibleapp/tool/erase | /bibleapp/tool/select
Pen Color:
/bibleapp/pen/color #ff0000 - Set pen color (hex)
/bibleapp/pen/color/<color> - Set pen color from route segment
Supported names: white, red, blue, green, yellow, black, orange, purple, pink, cyan
Presentation & Study:
/bibleapp/redletter - Toggle red-letter (words of Christ)
/bibleapp/laser - Toggle laser pointer
/bibleapp/spotlight - Toggle spotlight
/bibleapp/present/off - Turn off laser/spotlight
Navigation:
/bibleapp/goto John 3:16 - Jump to a passage (reference as argument)
/bibleapp/chapter/next | /bibleapp/chapter/prev - Next / previous chapter
Profiles & Toolbar:
/bibleapp/profile Sunday - Apply a service profile (name as argument)
/bibleapp/dock/float | /bibleapp/dock/rail - Float / dock the toolbar

Note: If a security token is configured, include it as an argument in your OSC messages.

OSC Feedback Paths Reference

The app sends OSC feedback messages back to Companion (or other OSC clients) after processing commands. Use these paths to listen for command confirmations and update button states.

Feedback Format:
                        Address: /bibleapp/feedback/<command>

                        Args: [status (1=success, 0=failure), error_message (optional), original_command]
                    
Command Feedback Paths:
/bibleapp/feedback/undo - Undo command feedback
/bibleapp/feedback/redo - Redo command feedback
/bibleapp/feedback/reset - Reset command feedback
/bibleapp/feedback/clear - Clear current tab feedback
/bibleapp/feedback/clear_all - Clear all tabs feedback
/bibleapp/feedback/close - Close tab feedback
/bibleapp/feedback/tab_left - Previous tab feedback
/bibleapp/feedback/tab_right - Next tab feedback
/bibleapp/feedback/new_bible_tab - New Bible tab feedback
/bibleapp/feedback/new_whiteboard_tab - New whiteboard tab feedback
/bibleapp/feedback/new_notes_tab - New notes tab feedback
/bibleapp/feedback/splash_show - Splash screen feedback
/bibleapp/feedback/tool_pen - Pen tool selection feedback
/bibleapp/feedback/tool_highlight - Highlight tool feedback
/bibleapp/feedback/tool_erase - Erase tool feedback
/bibleapp/feedback/tool_select - Select tool feedback
/bibleapp/feedback/pen_color/<hex6> - Pen color feedback (example: /bibleapp/feedback/pen_color/ff3333)
Live State Feedback Paths:
/bibleapp/feedback/state/tool_pen - Pen tool is currently active (1 active, 0 inactive)
/bibleapp/feedback/state/tool_highlight - Highlighter tool active state
/bibleapp/feedback/state/tool_erase - Eraser tool active state
/bibleapp/feedback/state/tool_select - Select tool active state
/bibleapp/feedback/state/pen_color/<hex6> - Active pen color state (1 active, 0 inactive)
/bibleapp/feedback/state/splash_visible - Splash visibility state (1 visible, 0 hidden)
/bibleapp/feedback/state/action_undo - Undo pulse for button flash feedback
/bibleapp/feedback/state/action_redo - Redo pulse for button flash feedback
/bibleapp/feedback/state/action_clear - Clear current tab pulse
/bibleapp/feedback/state/action_clear_all - Clear all tabs pulse
/bibleapp/feedback/state/action_splash_show - Splash show pulse
/bibleapp/feedback/state/action_new_bible_tab - New Bible tab pulse
/bibleapp/feedback/state/action_new_whiteboard_tab - New whiteboard tab pulse
/bibleapp/feedback/state/action_new_notes_tab - New notes tab pulse
/bibleapp/feedback/state/action_refresh - Refresh/reset pulse
Error Feedback Paths:
/bibleapp/feedback/blocked - IP address was blocked
/bibleapp/feedback/unknown - No matching route found
/bibleapp/feedback/tool - Invalid tool command

Usage in Companion: Listen for these feedback paths to update button states. Status 1 = success (use for button confirmation), Status 0 = failure (use for error indication). State paths under /bibleapp/feedback/state/* are also sent from app UI changes (not just OSC-triggered commands) so button states stay in sync.