Learn what the Generator program is, and how you can use it to import and use your own Bibles.
- The Generator program is only available in the Coffee Version.
- The Generator program only runs on supported platforms. Please refer to this FAQ question for details.
About the Generator
What is the Generator program? It is a portable executable that allows you to use your own Bibles with the Bible Plugin. It works by using a blank version of the Bible Plugin and filling it with the Bibles you have selected. It then copies the plugin to a folder of your choice.
Using the Generator has the following advantages:
- Customizable: choose which Bible translations you want.
- Offline access: you do not need an Internet connection to use the plugin.
- Self-contained: the generated plugin is contained in one folder.
Here are some things you should be aware of:
- The Generator program includes some common public domain Bibles but can also read other Bibles. If you plan to use other Bibles not already included, please keep in mind that the Generator program can only read OpenLP Bibles. For this case, OpenLP should already be installed on the same computer and should already have the Bibles that you want to use inside it.
- Setup, while mostly the same as the Online Version, is slightly more complex for the generated plugin. This is because you will be using your own local files instead of an Internet website.
Please refer to the following FAQ questions for other relevant information:
Using the Generator
When you launch the program, you will be presented with all the Bible translations that the Generator has detected. Check the Bibles that you would like to include.
If you click the Edit icon to the right of a Bible, you will enter the Bible editor. From here, you can customize the following:
- The name of the Bible translation. All selected Bibles must have unique names.
- The abbreviation of the Bible translation. This is usually all-caps and three to five letters long. The program will try to guess the abbreviation from the Bible name, but there may be times when you will have to manually set this.
- Bible copyright information.
- Select which books of the Bible you would like to include. For example, some Bibles include books from the Apocrypha, which you may not want.
When you are done, you can click Cancel to discard your changes or Save to apply them.
Remember to select which folder the plugin should be written to. Inside your chosen folder, a new folder named obs-bible-plugin will be created with all plugin files inside.
When all the settings are to your liking, click the Generate button. A dialog should appear informing you that plugin generation was successful.
The generator will then tell you how to setup the plugin in OBS Studio. It is very similar to the instructions for the online version, but there are a few differences.
To make it easier to follow this tutorial, you can enter the same output folder you set in the Generator here. This is an optional step.
These are the locations you need to enter in OBS Studio. Click on a link to copy.
Browser Source Setup
An OBS Studio Browser Source needs to be added in order for verses to be displayed. In the Sources panel at the bottom of OBS Studio, click the + icon.
In the popup menu, choose the Browser option.
Choose Create New and enter a name. We recommend Bible or Bible Browser to keep things simple.
Click OK. A new dialog window should appear.
Check the Local file option.
Set the width and height according to your preferences. You can always change this setting later.
Click OK to save all changes and close the dialog.
You should see a red rectangle on the screen with nothing inside. This is where Bible verses will appear.
If you like, you can drag the red rectangle to a location of your preference.
If the width/height is not to your liking, you can right-click the Bible browser source, click on Properties, and change them. Browser source setup is now complete.
Adding the Bible dock allows us to control what is shown in the Bible Browser Source. In the OBS Studio toolbar, click View → Docks → Custom Browser Docks…
A dialog window should appear. Enter a Dock Name. We recommend Bible or Bible Dock to keep things simple.
Click Apply. The Bible dock should open.
Close the Custom Browser Docks… dialog.
Drag the newly opened Bible dock to a location of your preference. The left or right sides of OBS Studio are good options.
If the dock is too small, resize it by dragging its side to a size of your preference. Setup for the dock is now complete.
You are now ready to use the plugin! Choose a Bible, enter a reference, and hit Submit. Click on any resulting verse and it should show up automatically on the browser source. Click it again to hide.
If you have any further questions, please refer to our guides or send us a message on our contact page.