Learn how to set up the Coffee Version using the File method. This guide covers how to set up the Bible plugin from scratch.
- The File method only uses the Generator program. The Server program is not used.
- For more information on alternative methods of setting up the Coffee Version and the pros and cons of each approach, please refer to the Coffee Version setup page.
If you already have the free online version set up in OBS Studio, you will need to remove it first. The Coffee Version and the Online Version are not compatible with each other; mixing both versions will likely cause issues and result in confusion.
After purchasing the Coffee Version, you will receive an email with a unique download link. If you click the link, you will see a number of files you can download.
For example, here are the files that were available in v1.4.4 of the Bible Plugin:
- Generator program for 64-bit Windows.
- Generator program for 32-bit Windows.
- Generator program for 64-bit Linux.
- Generator program for 64-bit Mac.
- Server program for 64-bit Windows.
- Server program for 32-bit Windows.
- Server program for 64-bit Linux.
- Server program for 64-bit Mac.
For File Setup, you only need the Generator program for your operating system. The Server program is not required.
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.
- File 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:
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.
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.
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
Docks → Custom Browser Docks… (OBS Studio v27.2.0+)
View → Docks → Custom Browser Docks… (OBS Studio pre-v27.2.0)
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.