Skip to content

Releases: ebena107/HymnFlow

🎡 HymnFlow v2.3.1 - Global Worship Enhanced

14 Jan 05:38

Choose a tag to compare

Release Date: January 14, 2026
Release Type: Feature + Documentation Release
Download:hymnflow-v2.3.1-plugin.zip


✨ What's New

HymnFlow v2.3.1 combines the powerful internationalization features of v2.3.0 with enhanced documentation to make setup crystal clear. This release represents a major leap forward in accessibility and usability for worship teams worldwide.


🌍 Major Features (v2.3.0 + v2.3.1)

1️⃣ Multi-Language Support (v2.3.0)

The HymnFlow interface now supports 9 languages, allowing operators to work in their native tongue!

Supported Languages:

  • πŸ‡¬πŸ‡§ English (Default)
  • πŸ‡ͺπŸ‡Έ EspaΓ±ol (Spanish)
  • πŸ‡«πŸ‡· FranΓ§ais (French)
  • πŸ‡΅πŸ‡Ή PortuguΓͺs (Portuguese)
  • πŸ‡ΉπŸ‡Ώ Kiswahili (Swahili)
  • πŸ‡΅πŸ‡­ Tagalog
  • πŸ‡³πŸ‡¬ YorΓΉbΓ‘ (Yoruba)
  • πŸ‡¨πŸ‡³ δΈ­ζ–‡ (Mandarin Chinese)
  • πŸ‡°πŸ‡· ν•œκ΅­μ–΄ (Korean)

How to change language:

  1. Open HymnFlow Dock in OBS
  2. Scroll to the Settings section
  3. Select your language from the Interface Language dropdown
  4. The UI updates immediately!

2️⃣ Official CAC Hymn Collections (v2.3.0)

Complete, verified hymn books from Christ Apostolic Church:

  • CAC Gospel Hymn Book (English): 1,001 hymns - 1.18 MB
  • CAC Yoruba Hymn Book (Iwe Orin CAC): 997 hymns - 969 KB

Plus standard collections:

  • Faith We Sing: 46 hymns - 44 KB
  • Baptist Hymnal (2008): 325 hymns - 352 KB
  • United Methodist Hymnal: 296 hymns - 337 KB
  • Yoruba Baptist Hymnal: 650 hymns - 582 KB

Total: 2,315 hymns across 6 collections!


3️⃣ Optimized "Hymn Bundle" Architecture (v2.3.0)

To keep the core application small and fast, large hymn collections have been moved into an optional Hymn Bundle available as a separate download.

Benefits:

  • βœ… Reduced Size: Core plugin download reduced from ~3MB to ~150KB (95% smaller!)
  • βœ… Faster Downloads: Get started quickly, download only the hymns you need
  • βœ… Separate Management: Update your hymn library without re-downloading the plugin
  • βœ… Community Ready: Easier to share and contribute new hymn books in JSON format
  • βœ… Individual Downloads: Each hymn collection available as a separate file

4️⃣ Crystal-Clear Documentation (v2.3.1)

Enhanced documentation to eliminate confusion about hymn file downloads:

  • πŸ“– Prominent notices explaining hymn files are a separate download
  • πŸ“– Step-by-step instructions for downloading hymn files from GitHub
  • πŸ“– Multiple download options (individual files or bulk download)
  • πŸ“– Updated setup wizard with clear separation messaging
  • πŸ“– Comprehensive guides in README, SETUP, and interactive HTML wizard

πŸ“‹ Complete Change Log

v2.3.1 (January 14, 2026) - Documentation Improvements

Changed:

  • πŸ“– Updated README.md with explicit hymn bundle download instructions
  • πŸ“– Updated doc/SETUP.md with detailed download options (GitHub folder or Releases)
  • πŸ“– Updated public/obs-setup.html with prominent notice that hymn files are separate downloads
  • πŸ”’ Bumped version to 2.3.1 in package.json and all HTML files
  • πŸ“‹ Created comprehensive release notes and OBS Project release documentation

Notes:

  • No functional changes to the application
  • Plugin download remains ~150KB (hymn files not included)

v2.3.0 (January 14, 2026) - Internationalization & Optimization

Added:

  • 🌍 Multi-language support for 9 languages
  • βš™οΈ Interface Language selector in Settings
  • πŸ’Ύ Persistent language preference (saved in localStorage)
  • 🧩 New i18n module for dynamic translation management
  • πŸ“‚ JSON-based translation files for easy community contribution
  • πŸ“š CAC Gospel Hymn Book (English) - 1,001 hymns
  • πŸ“š CAC Yoruba Hymn Book (Iwe Orin CAC) - 997 hymns
  • πŸ“¦ Optimized "Hymn Bundle" architecture (separate download)

Changed:

  • 🎯 Reduced core plugin size from ~3MB to ~150KB
  • πŸ“– Updated setup documentation for external data import

πŸ“₯ How to Get Hymn Files

Important

Hymn files are NOT included in the main plugin download to keep it lightweight.

Option 1: Download Individual Files from GitHub

  1. Visit the hymn-bundle folder on GitHub
  2. Click on the hymn file you want (e.g., cac_ghb.json)
  3. Click the "Download raw file" button or right-click "Raw" and select "Save link as..."
  4. Save to your computer (e.g., C:\HymnFlow\hymn-bundle\)

Option 2: Download from Releases

  1. Visit the Releases page
  2. Download the hymn-bundle.zip file (if available)
  3. Extract to your preferred location

Import into HymnFlow

  1. Open the HymnFlow Dock in OBS
  2. Click the Import button in the Hymns section
  3. Navigate to where you saved the .json file
  4. Select the hymn file (e.g., cac_ghb.json)
  5. Your hymns will be imported and ready to use!

🌟 Available Hymn Collections

All available as separate downloads from the hymn-bundle folder:

Collection Language Hymns Size
CAC Gospel Hymn Book English 1,001 1.18 MB
CAC Yoruba Hymn Book Yoruba 997 969 KB
Faith We Sing English 46 44 KB
Baptist Hymnal (2008) English 325 352 KB
United Methodist Hymnal English 296 337 KB
Yoruba Baptist Hymnal Yoruba 650 582 KB

Total: 3,315 hymns available for download!


πŸ”„ Migration from v2.2.x

No breaking changes! All existing hymns and styling settings are fully compatible.

If Upgrading from v2.2.x:

  1. Download and extract the new plugin
  2. Your existing hymns in localStorage will remain
  3. Select your preferred language in Settings
  4. Optionally download additional hymn collections

If Upgrading from v2.3.0:

  • No changes required! This is purely a documentation update
  • You don't need to update unless you want the latest documentation

πŸ“¦ What's Included in the Plugin Download

The hymnflow-v2.3.1-plugin.zip (~150KB) contains:

  • βœ… OBS Dock - Control panel for managing hymns
  • βœ… OBS Overlay - Lower-third display for streaming
  • βœ… i18n Translations - 9 language support files
  • βœ… Setup Guide - Interactive HTML setup wizard
  • βœ… Documentation - README, SETUP, TROUBLESHOOTING guides
  • βœ… Parsers - Support for .txt and .json import
  • βœ… Default Data - Sample hymns to get started

NOT Included:

  • ❌ Hymn Collections - Download separately (see above)

🎬 Quick Start

1. Download Plugin

2. Setup in OBS

  • Add Custom Dock: View β†’ Docks β†’ Custom Browser Docks
    • Name: HymnFlow Control
    • URL: file:///C:/HymnFlow/obs-dock/index.html
  • Add Browser Source: Add Source β†’ Browser Source
    • Name: Hymn Lower-Third
    • URL: file:///C:/HymnFlow/obs-overlay/index.html
    • Size: 1920x1080

3. Download Hymn Files

4. Import and Use

  • Click Import in the dock
  • Select your downloaded .json file
  • Start displaying hymns!

🎨 Core Features

  • 🎯 Zero-Latency - Pure browser localStorage communication (no server required)
  • 🌍 International - UI in 9 languages and growing
  • 🎨 Customizable - Control fonts, colors, outlines, shadows, and animations
  • ⌨️ Keyboard-Driven - Arrow keys for seamless verse/line navigation
  • πŸ”„ Smart Chorus - Automatic chorus display after every verse
  • πŸ“… Service Scheduling - Pre-plan your hymn order before services start
  • πŸ’Ύ Persistent Storage - Hymns saved in browser localStorage
  • πŸ“± Responsive - Works on any screen size
  • πŸ“₯ Import/Export - Support for .txt and .json hymn files

πŸ™ Credits

Internationalization: Community Contributors & Media Team
CAC Hymn Collections: Christ Apostolic Church
Implementation: HymnFlow Development Team
Built by: Gloryland Baptist Church, Owode-Ede (@gbcowode), Media Team


πŸ”— Resources


🀝 Community

Help Us Grow

  • 🌍 Translations: Can you help translate HymnFlow to a new language? Join our GitHub discussions!
  • πŸ“š Hymn Collections: Have a hymn book you'd like to contribute? We'd love to include it!
  • πŸ› Report Issues: Found a bug? Open an issue
  • πŸ’‘ Suggest Features: Have an idea? Share it in Discussions

πŸ“„ License

GPL-2.0 License - Same as OBS Studio. Free to use and modify for your worship services!


Empowering worship teams worldwide with seamless hymn display! 🎡🌍✨

HymnFlow v2.2.0 - Chorus Display Release

08 Jan 19:38

Choose a tag to compare

🎡 HymnFlow v2.2.0 - Chorus Display Release

Release Date: January 8, 2026
Release Type: Feature Release


✨ What's New

HymnFlow v2.2.0 introduces a highly requested feature: Automatic Chorus Display. This update transforms the navigation experience, ensuring that hymns with choruses are displayed correctly and efficiently during live worship services.


🎯 Major Features

1️⃣ Automatic Chorus Sequencing (NEW)

HymnFlow now understands the natural flow of a hymn. When a hymn has a chorus, the system automatically inserts it into the navigation sequence after every verse.

Features:

  • βœ… Smart Sequencing: Navigating "Next" now follows the logical order: Verse 1 β†’ Chorus β†’ Verse 2 β†’ Chorus ...
  • βœ… Dynamic Labeling: The OBS Overlay now displays a clear "Chorus" label instead of a verse number when the chorus is active.
  • βœ… Seamless Reversion: "Previous" navigation correctly steps back through the sequence, allowing you to return to the preceding verse or chorus perfectly.
  • βœ… Boundary Awareness: Line-by-line navigation (Up/Down arrows) automatically transitions between verses and choruses without manual intervention.

2️⃣ Functional "Jump to Chorus" (ENHANCED)

The "Jump to Chorus" button has been fully implemented.

Features:

  • βœ… Instant transition to the chorus from any verse.
  • βœ… Auto-updates both the preview and the live OBS overlay.
  • βœ… Smart state management: The system knows you are now in the "Chorus" state for subsequent navigation.

🎡 HymnFlow v2.1.0 - Major Enhancement Release

06 Jan 20:53
1fda526

Choose a tag to compare

🎡 HymnFlow v2.1.0 - Major Enhancement Release

Release Date: January 5, 2026
Release Type: Feature Release
Download: hymnflow-v2.1.0-plugin.zip


✨ What's New

HymnFlow v2.1.0 brings three significant enhancements to the dock interface, making it more powerful for professional worship leaders and A/V operators. All features requested by Michael Fasina community feedback.


🎯 Major Features

1️⃣ Text Outline Styling (NEW)

Add crisp text outlines (strokes) for better readability over complex backgrounds.

Features:

  • βœ… Toggle outline on/off with checkbox
  • βœ… Customizable outline color picker
  • βœ… Adjustable outline width (1-5px)
  • βœ… Real-time preview
  • βœ… Settings persist across sessions

Why? When displaying hymns over video, images, or live camera feeds, text outlines provide critical contrast for readability. Shadow and glow effects work well, but outlines give the sharpest, most professional appearance.

How to Use:

  1. Open Styles section in dock
  2. Check "Outline" checkbox
  3. Select outline color with color picker
  4. Adjust width with slider (1-5px recommended)
  5. Settings apply immediately to overlay

Technical: Uses -webkit-text-stroke for broad browser compatibility (Chrome, Edge, Firefox).


2️⃣ Hymn Editing (NEW)

Edit hymns directly in the dock to fix typos and make corrections without re-importing.

Features:

  • βœ… Edit button in Hymns section (next to + Add, - Remove)
  • βœ… Modal form with all hymn fields:
    • Hymn Number (optional metadata)
    • Title (required)
    • Author
    • Verses (textarea with blank-line separation)
    • Chorus (optional)
  • βœ… Full validation (title and verses required)
  • βœ… Preserves hymn ID (references maintained)
  • βœ… Immediate UI refresh

Why? Typos happen. Previously, users had to:

  • Delete and re-import (losing metadata)
  • Manually edit localStorage JSON (error-prone)
  • Live with the error

Now: One click β†’ Edit β†’ Save β†’ Done!

How to Use:

  1. Select hymn from list
  2. Click "✏️ Edit" button
  3. Make corrections in modal
  4. Click "Save Changes"
  5. Hymn updates in list and preview

Technical: Modal form with client-side validation, updates hymn object while preserving ID.


3️⃣ Service/Program Scheduling (NEW)

Pre-organize hymns for services, programs, and events. Perfect for:

  • Sunday morning/evening services
  • Bible study sessions
  • Special events (Easter, Christmas, weddings, funerals)
  • Multi-language services

Features:

  • βœ… Create named services ("Sunday Morning - Jan 5", "New Year Service", etc.)
  • βœ… Add hymns to services in sequence
  • βœ… Reorder hymns with up/down buttons
  • βœ… Load service to display only those hymns
  • βœ… Navigate through service hymns with Previous/Next verse buttons
  • βœ… All services saved to localStorage
  • βœ… Delete services anytime

Workflow:

1. Click "+ New" in Services section
2. Enter service name (e.g., "Sunday Morning")
3. Click "+ Add Hymn" to add hymns in order
4. Reorder with ↑↓ buttons if needed
5. Click "Save Service"
6. Later: Click "Load" to activate service
7. Navigate through hymns normally

Why? Worship services follow planned hymn orders. Scheduling:

  • Reduces search time during live service
  • Prevents accidentally selecting wrong hymn
  • Works offline with no internet
  • Allows planning before service starts

Technical: Services stored as arrays of hymn IDs in localStorage (key: hymnflow-services). Reordering is instant, no re-importing needed.


πŸ“‹ Complete Change Log

Added

  • 🎨 Text outline styling with color and width control
  • ✏️ Full hymn editor with modal form
  • 🎯 Service/program scheduling system
  • πŸ“Œ Service load/save functionality
  • ↕️ Hymn reordering in services

Enhanced

  • Improved Styles section layout
  • Better form validation
  • Enhanced modal UI for editing
  • Slim single-line color indicators in style controls (more compact UI)

Fixed

  • Style setting changes (including outline color/width) now update the live overlay instantly when a hymn is displayed

πŸ”„ Migration from v2.0.x

No breaking changes! All existing data is compatible:

  • βœ… Hymns migrate automatically
  • βœ… Settings persist as-is
  • βœ… No re-import needed
  • βœ… Just upgrade and use

πŸ“Š Feature Comparison

Feature v2.0.0 v2.0.1 v2.1.0
Hymn Management βœ… βœ… βœ…
Quick Edit ❌ ❌ βœ…
Text Outline Styling ❌ ❌ βœ…
Service Scheduling ❌ ❌ βœ…
Customizable Styling βœ… βœ… βœ…
Keyboard Navigation βœ… βœ… βœ…
Import/Export βœ… βœ… βœ…

🎬 Quick Start

For v2.0.x Users

  1. Backup (optional): Export hymns from dock
  2. Replace files in your HymnFlow folder with v2.1.0 files
  3. Reload custom dock in OBS (no reconfiguration needed)
  4. No data loss - everything stays the same

Trying New Features

Text Outline

  • Open OBS Dock β†’ Styles section
  • Check "Outline" checkbox
  • Pick outline color
  • Set width to 2-3px for best results

Hymn Editing

  • Select hymn from list
  • Click "✏️ Edit" button
  • Fix typos in modal
  • Click "Save Changes"

Service Scheduling

  • Click "+ New" in Services section
  • Name your service
  • Click "+ Add Hymn" to add hymns in order
  • Save and load during service

πŸ” Technical Details

New Settings Keys (localStorage)

  • hymnflow-dock-settings.outline (boolean)
  • hymnflow-dock-settings.outlineColor (hex color)
  • hymnflow-dock-settings.outlineWidth (number 1-5)
  • hymnflow-services (array of service objects)

Service Data Structure

{
  id: "srv_${timestamp}",
  name: "Service Name",
  hymns: ["hymn_id_1", "hymn_id_2", "hymn_id_3"]
}

Browser Compatibility

  • βœ… Chrome/Chromium (OBS uses Chromium)
  • βœ… Edge
  • βœ… Firefox
  • ⚠️ Safari (limited -webkit-text-stroke support)

πŸ› Known Issues / Limitations

  • None reported in beta testing
  • Modal styling optimized for dock width (420px max)
  • Service names limited to ~50 characters for display
  • Maximum ~1000 services before localStorage limits

πŸ†˜ Support & Feedback

Having issues?

Like what you see?


πŸ™ Credits

Feature Requests by: Michael Fasina
Implementation: HymnFlow Development Team (Gloryland Baptist Church, Owode-Ede, Nigeria)
Community Feedback: Global worship leaders and A/V operators


πŸ“ Version History

Version Date Focus
v2.1.0 Jan 5, 2026 Editing, Outline, Scheduling
v2.0.1 Jan 5, 2026 Vertical Dock, Hymn Numbers
v2.0.0 Jan 4, 2026 Initial Stable Release
v1.0.0 (archived) Server-based version

πŸ”— Resources


πŸ“„ License

HymnFlow v2.1.0 is released under the GPL-2.0 License - Same as OBS Studio.
Free to use in churches, ministries, and commercial settings.


Enjoy the enhanced HymnFlow experience! 🎡✨

Questions? Ideas? Let's build the best hymn display tool together!

HymnFlow-v2.0.0

05 Jan 14:19

Choose a tag to compare

hymnflow-v2.0.0-plugin.zip

🎡 HymnFlow v2.0.0 - Initial Stable Release

Release Date: January 4, 2026
Release Type: Major Release - Stable
Download: hymnflow-v2.0.0-plugin.zip


πŸŽ‰ What's New

HymnFlow v2.0.0 is the first stable release of a browser-based OBS Studio plugin for displaying hymns during worship services. This release focuses on simplicity, reliability, and ease of use.

✨ Key Features

πŸŽ›οΈ OBS Custom Dock Control Panel

  • Complete hymn library management (add, remove, search, import, export)
  • Real-time preview of current hymn and verse
  • Navigation controls (previous/next verse, line-by-line navigation)
  • Keyboard shortcuts for fast operation during live services
  • Visual display toggle with state indicators

πŸ“Ί OBS Browser Source Overlay

  • Lower-third display perfect for worship presentations
  • Smooth animations (fade, slide, or none)
  • Customizable positioning (bottom, middle, top)
  • Automatic updates as you navigate in the dock

🎨 Powerful Styling Options

  • Font family selection (Inter, Segoe UI, Roboto, Georgia, Montserrat)
  • Font size control (24px - 96px)
  • Text effects: Bold, Italic, Shadow, Glow
  • Text color picker
  • Background types: Transparent, Solid, Gradient
  • Custom background colors with gradient support

πŸ“₯ Import/Export System

  • TXT format: Simple text-based format for easy hymn entry
  • JSON format: Structured data with full metadata support
  • Export: Backup your entire hymn library as JSON
  • Default hymns included (English samples)

πŸ”„ Smart Navigation

  • Auto-advance between verses when reaching line boundaries
  • Configurable lines per display (2-6 lines)
  • Jump to chorus functionality
  • Emergency clear button for instant hide

πŸ’Ύ Browser-Based Storage

  • All data stored in browser localStorage (~5-10MB capacity)
  • No server required - works offline
  • Persistent across browser sessions
  • Can handle thousands of hymns

πŸ—οΈ Architecture

Pure Client-Side Design

HymnFlow uses an innovative localStorage + storage events architecture:

OBS Custom Dock (Control) ←→ localStorage ←→ OBS Browser Source (Display)

Benefits:

  • βœ… No server installation or configuration
  • βœ… No network dependencies
  • βœ… Works with file:// protocol (direct file access)
  • βœ… Zero latency communication
  • βœ… Simple deployment and updates

File Structure

hymnflow-v2.0.0/
β”œβ”€β”€ obs-dock/           # Control panel HTML/CSS/JS
β”‚   β”œβ”€β”€ index.html
β”‚   β”œβ”€β”€ obs-dock.css
β”‚   └── obs-dock.js
β”œβ”€β”€ obs-overlay/        # Display overlay HTML/CSS/JS
β”‚   β”œβ”€β”€ index.html
β”‚   β”œβ”€β”€ overlay.css
β”‚   └── overlay.js
β”œβ”€β”€ data/               # Default hymn library
β”‚   β”œβ”€β”€ hymns-data.js
β”‚   └── hymns.json
β”œβ”€β”€ parsers/            # Import format parsers
β”‚   β”œβ”€β”€ txtParser.js
β”‚   β”œβ”€β”€ csvParser.js
β”‚   └── jsonParser.js
└── Documentation files (README, SETUP, etc.)

Total Size: ~150-200 KB


πŸš€ Getting Started

Quick Setup (5 Minutes)

  1. Download & Extract

    • Download hymnflow-v2.0.0-plugin.zip
    • Extract to C:\HymnFlow\ (or any location)
  2. Add Custom Dock in OBS

    View β†’ Docks β†’ Custom Browser Docks
    Dock Name: HymnFlow Control
    URL: file:///C:/HymnFlow/public/obs-dock/index.html
    
  3. Add Browser Source

    Add Source β†’ Browser Source
    Name: Hymn Lower-Third
    URL: file:///C:/HymnFlow/public/obs-overlay/index.html
    Width: 1920, Height: 1080
    
  4. Import Your Hymns

    • Click Import in the dock
    • Select your .txt or .json file
    • Start displaying!

Detailed Instructions: See SETUP.md


πŸ“‹ System Requirements

Minimum Requirements

  • OBS Studio: v27.0 or higher (v29+ recommended)
  • Operating System: Windows 10/11, macOS 10.15+, Linux (Ubuntu 20.04+)
  • Browser Engine: Chromium-based (OBS uses CEF - Chromium Embedded Framework)
  • Disk Space: ~1 MB for plugin files
  • localStorage: ~5-10 MB available (standard browser allocation)

Recommended

  • OBS Studio: v29.1+ (latest stable)
  • Display Resolution: 1920x1080 or higher
  • RAM: 8 GB+ (for smooth OBS operation)

🎯 Use Cases

Perfect For:

  • ✝️ Church worship services (Sunday services, prayer meetings, special events)
  • 🎀 Small to medium congregations
  • πŸ“Ί Live streaming worship (YouTube, Facebook, Vimeo)
  • 🎢 Multi-language worship (import different hymn collections)
  • 🏫 Bible study groups with hymn singing

Tested Scenarios:

  • βœ… Sunday morning services with 20+ hymns
  • βœ… Live streaming with OBS Studio
  • βœ… Multiple services with different hymn sets
  • βœ… Quick hymn changes during live worship
  • βœ… Keyboard-only operation for A/V operators

⌨️ Keyboard Shortcuts

Key Action
β†’ Right Arrow Next verse
← Left Arrow Previous verse
↓ Down Arrow Next line window
↑ Up Arrow Previous line window
Space Toggle display (show/hide)

πŸ“¦ What's Included

Core Files

  • obs-dock/ - Control panel (3 files)
  • obs-overlay/ - Display overlay (3 files)
  • parsers/ - Import parsers (3 files)
  • data/ - Default hymns (2 files)

Documentation

  • README.md - Project overview and features
  • SETUP.md - 5-minute setup guide
  • TROUBLESHOOTING.md - Common issues and solutions
  • SECURITY.md - Security policy
  • LICENSE - MIT License

Development Files

  • .github/ - GitHub templates and workflows
  • scripts/ - Release automation scripts
  • doc/ - Developer documentation

πŸ”’ Security & Privacy

  • βœ… No data collection - Everything stays on your computer
  • βœ… No network calls - Works completely offline
  • βœ… No tracking - No analytics or telemetry
  • βœ… No external dependencies - Pure vanilla JavaScript
  • βœ… Open source - Full code transparency (MIT License)

Data Storage: All hymns and settings stored in browser localStorage (OBS's internal Chromium instance). Data never leaves your computer.


🀝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Ways to Contribute:

  • πŸ› Report bugs via GitHub Issues
  • πŸ’‘ Suggest features
  • πŸ“ Improve documentation
  • 🌍 Add translations or multi-language hymn collections
  • 🎨 Design improvements
  • πŸ’» Code contributions (PRs welcome!)

πŸ“œ License

HymnFlow is released under the MIT License.

Commercial Use Allowed - Free to use in churches, ministries, and commercial settings.


πŸ™ Acknowledgments

  • Built for the global worship community
  • Inspired by the need for simple, reliable hymn display solutions
  • Designed with A/V operators and worship leaders in mind

πŸ”— Resources


πŸ“ Release Notes

What's Included in v2.0.0

βœ… Complete OBS Studio integration (custom dock + browser source)
βœ… Hymn management (add, delete, search, import, export)
βœ… Real-time navigation with keyboard shortcuts
βœ… Customizable styling and animations
βœ… Smart line-by-line navigation with auto-verse advancement
βœ… Visual display toggle with state indicators
βœ… Responsive design for various screen sizes
βœ… Comprehensive documentation
βœ… Default English hymn samples included

Known Limitations

  • localStorage limited to ~5-10 MB (thousands of hymns)
  • OBS dock and overlay must be from same origin (same folder structure)
  • Browser-specific localStorage (separate OBS profile = separate storage)

Planned for Future Releases

See GitHub Issues for planned features and enhancements.


πŸ†˜ Support

Having issues? Check TROUBLESHOOTING.md first.

Need help? Open an issue: GitHub Issues


Happy Worshiping! 🎡✨


HymnFlow v2.0.0 - Browser-based OBS hymn display plugin
Released: January 4, 2026
License: MIT