Bible Song Pro – OBS Overlay for Bible Verses & Song Lyrics

A modern church presentation system for OBS Studio that lets you display Bible verses and song lyrics in real-time.

---

Preview

Fresh Look in v2.1.0

Core Workflows

---

Get Started

👉 Download the latest version: Download Here

👉 Watch demo: YouTube Demo

---

Features

• Real-time Bible verse display
• Auto-Retrieve Lyrics
• Real-time song lyrics presentation
• Clean broadcast-style UI
• Fully customizable display
• Lightweight and fast
• Works directly inside OBS Browser Source
• AI Scripture Assistant — real-time speech detection that listens to your sermon and instantly surfaces Bible references as you speak, keeping your operator always one step ahead
• Independent Lower Third & Full Screen backgrounds — set a different visual background for each display mode, with a one-click Link button to mirror both simultaneously

---

What Is New In v2.1.0 (Compared To OBS-2)

New Features Added

• AI Scripture Assistant (Live Scripture HUD) — a floating, real-time detection panel that listens to spoken audio during worship or preaching and automatically identifies Bible references and song cues. Works for both Bible verse projection and song lyrics display. Runs fully offline with Local AI (Moonshine) or in the cloud via Deepgram — no interruption to your flow
• Independent Lower Third and Full Screen Backgrounds — Lower Third and Full Screen modes now each carry their own dedicated background layer (solid color, image, video, or YouTube). A single Link toggle instantly mirrors both modes to the same background whenever consistency is needed
• Dedicated AI Helper desktop app with relay-based control and a clean companion UI
• Cross-platform helper packaging for macOS (Intel and Apple Silicon), Windows (installer and portable), and Linux (AppImage and zip)
• New feedback pipeline: local backend and Cloudflare Worker deployment option for public issue intake
• Expanded vMix workflow support with display URL tools, connection state UI, and advanced output routing controls
• New tutorial hub module and broader modular project structure for maintainability

Fixes And Reliability Improvements

• Major sync/output runtime hardening to reduce state drift and improve live output consistency
• Better relay/session resilience with reconnect actions and clearer connection visibility in UI
• Improved state persistence and sanitization for recent/pinned Bible references and host settings
• Better input safety through typing shortcut guards to prevent accidental hotkey triggers while editing fields
• Startup behavior improvements including vMix reconnect-on-start and safer restore flows

---

Setup (2 Minutes)

1. Open OBS Studio
2. Add BSP_display.html as a Browser Source in your scene
3. Add Bible Song Pro panel.html as an OBS custom browser dock
4. Open the panel and start controlling your live display

---

How It Works

• Bible Song Pro panel.html -> Control interface
• BSP_display.html -> OBS output screen
• Real-time sync via BroadcastChannel API

---

Built for Churches

Bible Song Pro is designed to help churches and ministries present scripture and song lyrics beautifully during live streams without complex software.

---

Demo

Watch it in action:
https://www.youtube.com/watch?v=4SVs5jyYx3o

---

Download

Get the latest version here:
https://github.com/Johnbatey/bible-song-pro-obs/releases/latest

---

Tech Stack

• HTML, CSS, JavaScript
• BroadcastChannel API
• OBS Browser Source

---

Support

• Instagram: https://www.instagram.com/johnsonolakotan
• 

---

Feedback Backend

To let the in-app Feedback form create GitHub issues directly, run the bundled backend:

1. Set environment variables:
2. GITHUB_TOKEN = a GitHub token with issue write access
3. GITHUB_REPO = Johnbatey/bible-song-pro-obs (or another owner/repo)
4. Optional: FEEDBACK_PORT = backend port, default 8787
5. Start the server:
6. npm run feedback:server
7. Start the app and use the Feedback tab. The public build uses the bundled default feedback endpoint automatically.

Health check: - http://127.0.0.1:8787/health

The backend keeps the GitHub token on the server side and returns the created issue URL to the app.

---

Feedback Worker

For public deployment without keeping your PC running, use the Cloudflare Worker in feedback-worker.

Quick path:

1. cd feedback-worker
2. npm install
3. npx wrangler login
4. npx wrangler secret put GITHUB_TOKEN
5. npm run deploy
6. If you change the deployed Worker in future, update the default feedback endpoint in the panel source.
7. Current deployed Worker: https://bible-song-pro-feedback.johnbatey-bsp.workers.dev/api/github-feedback

The Worker setup is documented in feedback-worker/README.md.

---

License

GPL-3.0. See LICENSE for full terms.