Bible Library and Scripture Overlays
Bible Library and Scripture Overlays
Applies to: Current VideoHub360 theme package
Purpose
The Bible Library stores complete Bible translations for use in Studio scripture overlays. Studio reads imported verses from its database tables; it does not parse the CSV during a live production.
Open the Bible Library
Go to VideoHub360 → Bible Library. Only administrators can manage translations.
The translation table shows the translation name, abbreviation, language, status, book count, verse count, dataset version, import date, source, license, attribution requirement, and available actions.
Prepare the CSV
The first row must be exactly:
Book,Chapter,Verse,Text
Each remaining row must contain exactly four columns:
- Book: A recognized Bible book name.
- Chapter: A positive chapter number.
- Verse: A positive verse number. A single-letter verse suffix is supported when present in the dataset.
- Text: The verse text in valid UTF-8.
The importer accepts complete 66-book translations. A completed import must contain all 66 books and at least 25,000 present verses.
Enter Translation Metadata
Complete these fields before importing:
- Translation key: A unique key of no more than 64 characters.
- Translation name
- Abbreviation
- Language
- Dataset source
- License name
- Dataset version
Source URL and license URL may also be supplied.
Enable Attribution is required by this license only when the source license requires attribution. When enabled, attribution text is required, is limited to 500 characters, and is displayed on Bible overlays.
Select I confirm permission to use this file before starting the import. Import only material you are legally permitted to store and display.
Import a Translation
- Go to VideoHub360 → Bible Library.
- Complete the translation metadata.
- Select the CSV file.
- Confirm permission to use the file.
- Click Import translation.
- Monitor the Import Jobs table until the job completes.
The job table reports processed, imported, omitted, and failed rows. Use the available job action to continue an interrupted import. Cancel and clean a failed job before uploading a corrected file when necessary.
An import is not installed until validation succeeds. Validation fails when the CSV header is wrong, rows are malformed, books are unrecognized, the translation is incomplete, or the minimum verse count is not met.
Manage Installed Translations
- Disable: Removes the translation from Studio selectors without deleting its verses.
- Enable: Returns a disabled translation to Studio selectors.
- Delete: Deletes the translation and all stored verses.
Deleting a translation is permanent. Confirm that no saved Studio cues depend on it before deletion.
Load Scripture in Studio
- Open Studio.
- Open Overlays → Bible.
- Select an enabled translation.
- Enter a reference and click Load Reference, or select the book, chapter, start verse, and end verse and click Load Selected Passage.
A resolved passage can contain up to 50 verses. Use a shorter selection when the reference is too large.
Customize the Overlay
Choose a template:
- Lower Band
- Scripture Card
- Full-Width Scripture Panel
Configure the position, scale, background color and opacity, scripture color, reference color, text alignment, verse-number display, reference display, translation-abbreviation display, and maximum lines per page.
When the selected translation requires attribution, Studio preserves the required attribution display.
Page a Long Passage
Studio divides long passages into pages according to the maximum-lines setting. Use Previous Preview Page and Next Preview Page to select the page staged in Preview.
Save and Use Cues
- Load and style a passage.
- Enter a cue name.
- Save the cue.
- Use Previous Cue or Next Cue to move through saved cues.
- Stage the selected cue in Preview.
- Take it to Program when ready.
Updating Preview does not change the active Program overlay until the overlay is taken to Program.
Troubleshooting
The CSV is rejected immediately
Confirm the first row is exactly Book,Chapter,Verse,Text and every data row contains exactly four columns.
The import fails validation
Confirm the dataset contains all 66 recognized books and at least 25,000 present verses. Review failed and omitted row counts in the Import Jobs table.
A translation does not appear in Studio
Confirm its status is installed, not disabled, then reload Studio.
Required attribution is missing
Edit the source data and reimport the translation with Attribution is required by this license enabled and attribution text supplied.
