Bible Plugin for OBS Studio

Semi-free Bible Plugin for OBS Studio

Hi, everyone!

This update does two things:

First up is keyboard shortcuts on buttons! You can toggle this feature on or off in the Settings. Once again, special thanks to user hopkir from the OBS Forums for suggesting this! (And sorry it took this long :D )

Bottom Bar
2021-11-27 Keyboard Shortcuts Bottom Bar.png


Toolbar
2021-11-27 Keyboard Shortcuts Toolbar.png


You can toggle this on or off by clicking the new "Show Keyboard Shortcuts on Buttons" option. It is enabled by default.

New Settings
2021-11-27 New Settings.png


You may be wondering what "Strip Verse Newlines" and "Strip Footnote References" do, which leads us to the next item on the update list.

The second is improved whitespace handling for verse texts. Columbian YouTuber Daniel Monsalve brought to my attention that some popular Spanish Bibles displayed weirdly on the plugin. After some digging, it turned out that this was because the Bibles embedded newlines and additional whitespace inside the verses. This means that Bible verses previously appeared something like this (there was also a leading newline there, but it's not in the photo because I forgot to take a screenshot of the earlier version):

2021-11-27 Newlines Not Stripped.png


To fix this, leading and trailing whitespace are now removed. As for the newlines, you can now change them to be more natural by enabling the "Strip Verse Newlines" option (enabled by default):

2021-11-27 Newlines Stripped.png


While I was at it, I also added an option to "Strip Footnote References", just because (enabled by default).

"Strip Footnote References" Disabled
2021-11-27 Footnote Refs Not Stripped.png


"Strip Footnote References" Enabled
2021-11-27 Footnote Refs Stripped.png


Special thanks to YouTuber Daniel Monsalve for bringing this to my attention, and for his patience and support while I worked on this. Be sure to check out his YouTube channel here (in Spanish): https://www.youtube.com/user/danimonl. Also, if everything goes well and no more unexpected issues pop up, stay tuned for Daniel's upcoming video in Spanish on the Coffee Version as well!

Update Guide

Important: Please backup your verse list and custom themes before updating!


Free Online Version
You will automatically be updated to the latest version.

Coffee Version
  1. Download the latest release from Payhip.
  2. Run the Generator, choose the same Bibles and output folder, and click Generate.
  3. Open OBS Studio. You should be on the latest version.

Side Note: About Jon and Joanna from Firstfruits Studio

For those of you who contacted Firstfruits Studio by email or social media, you may have noticed replies signed by either "Jon from Firstfruits Studio" or "Joanna from Firstfruits Studio". We have been asked about this, so here is a brief explanation.

The sole creator, developer, and maintainer of Bible Plugin for OBS Studio is me, Jon from Firstfruits Studio. In the beginning, I handled all email and social media messages as well. However, as the plugin exploded in popularity and messages kept coming, I had to dedicate more and more time to responses and less time to development. Thankfully, my sister Joanna offered to help. That is why you may see messages from either of us. Of course, it doesn't matter which of us ends up replying. We both work together to answer and help out. :D

Conclusion

Thank you all for your support! God bless!

~ Jon and Joanna from Firstfruits Studio
  • Like
Reactions: hopkir
Hi, everyone!

This update adds a lot of things to make the plugin much more keyboard-friendly. Once again, special thanks to user hopkir from the OBS Forums for his invaluable suggestions!

New Keyboard Shortcuts Settings
2021-11-20 Keyboard Shortcuts.png


Default Keyboard Shortcuts

You are free to customize or unset each shortcut as you see fit! However, please take note that keyboard shortcuts will only work if the dock has focus.

App (Global)

To Search ModeCtrl + 1
To Bible ModeCtrl + 2
To List ModeCtrl + 3
To Theme ModeCtrl + 4
To Settings ModeCtrl + 5
Quick Show / HideCtrl + .

Bible

Previous ChapterCtrl + ArrowLeft
Next ChapterCtrl + ArrowRight
Previous List ItemCtrl + Alt + ArrowLeft
Next List ItemCtrl + Alt + ArrowRight
Add to ListCtrl + =
Change Verse RangeCtrl + -
Hide / RefreshCtrl + /

List

Move Item UpCtrl + ArrowUp
Move Item DownCtrl + ArrowDown

If you're interested, feel free to let me know what you think of the default shortcuts.

About Default Shortcuts Using Ctrl

Originally, I used Alt instead of Ctrl as the modifier key of choice for the default shortcuts. However, in OBS Studio on my Windows 10 system, this caused the system bell to keep ringing. As a result, I changed it to use Ctrl instead. Just in case anyone's interested. (For more information, see http://support.inqscribe.com/knowle...-to-turn-off-windows-default-beep-for-alt-key)

Other Changes
  • On switch to Search Mode, the reference field is now selected and given focus.
  • List Mode now supports keyboard input: arrow keys to choose and Enter to select.
  • Bible book suggestions in the reference field also accept keyboard input now: arrow keys to choose and Enter to select.
  • Some notifications now avoid taking focus from other inputs (for example, the Unrecognized Reference error notification will no longer steal input focus from the reference field).
  • The dock now has a subtle border indicating it has focus, useful to know at a glance whether keyboard shortcuts can be used.
  • Bible Mode now has the ability to go to the previous or next list item, currently only triggered via keyboard shortcuts.
  • Bible Mode has improved focus and selected states (more on this below).
Focus and Select States in Bible Mode

In Bible Mode, a verse can be focused (shown with a blue border) and selected (shown with a gray background). A focused verse responds to keyboard inputs, while a selected verse shows which verse is currently being displayed. Usually, a verse is either focused or focused + selected. But there are some cases in which the focused and selected verses are different.

2021-11-20 Unsynced Focus and Select States.png


Before, in this scenario, the plugin would try to make the next focused item selected. For mouse users, this wasn't a problem; but for keyboard users, this could cause some confusing behavior. With this update, only the focused item will move if a discrepancy is detected. This lines up more closely with expected behavior, but it has the drawback that using the arrow keys will no longer move the selected verse. Clicking a new verse, hitting Enter on a new verse, or right-clicking the currently selected verse and choosing the option "Focus & Sync" will sync up both states again, though, allowing you to control both focus and selection with the arrow keys once more.

In my opinion, this behavior is good enough. My brother thinks so too, but my sister suggested bringing this up for feedback. If anyone is interested, feel free to let me know whether you think this behavior is all right.

Update Guide

Important: Please backup your verse list and custom themes before updating!


Free Online Version
You will automatically be updated to the latest version.

Coffee Version
  1. Download the latest release from Payhip.
  2. Run the Generator, choose the same Bibles and output folder, and click Generate.
  3. Open OBS Studio. You should be on the latest version.

Future

Thanks for all your feedback and suggestions so far. I'll be somewhat busy for a while; so major updates like the ones so far will likely not be as frequent as before. However, I do read every single comment and message; so feel free to let me know your thoughts and ideas.

Thank you all for your support! God bless!

~ Jon from Firstfruits Studio
Hi, everyone!

Version 1.3.0 is now out, and with it a couple of new features.

Search Improvements

Bible reference searching has been tweaked to provide a better user experience:
  • Diacritics in Bible book names are ignored in searching and suggestions. This means you don't have to always type out accented letters. In the Spanish Reina-Valera Antigua, for example, you can type "Genesis 1" instead of "Génesis 1".
  • Partial Bible book names are now supported. For example, you can type "gen 1" to mean "Genesis 1" or "song 3:5-6" to mean "Songs of Solomon 3:5-6". In contrast, typing "jo 1" would fail because many Bible books start with those letters (Joshua, Job, Joel, and so on). As long as it's not ambiguous, the plugin will try to guess which book you mean. Special thanks to user hopkir from the OBS forums for suggesting this feature!
  • Finally, typing a book alone will now show "Please specify a chapter" rather than "Unrecognized reference". I have received a lot of messages from people who ran into this issue. I hope this helps!
Bibles

The French Bible Louis Segond (LSG) and the Spanish Bible Reina-Valera Antigua (RVA) are now official. They are no longer considered to be experimental. As a result, they are now available both online and in the Coffee Version.

Minor Tweaks
  • New toolbar help buttons have been added to the Settings and Theme Edit screens.
  • Added the logo and link to Firstfruits Studio in the Settings screen.
  • The Submit button in Search Mode now displays "Submit" in all languages.
Update Guide

Important: Please backup your verse list and custom themes before updating!


Free Online Version
You will automatically be updated to the latest version.

Coffee Version
  1. Download the latest release from Payhip.
  2. Run the Generator, choose the same Bibles and output folder, and click Generate.
  3. Open OBS Studio. You should be on the latest version.

Closing

It has almost been a month since I first announced the beta release of Bible Plugin for OBS Studio on this forum. Since that time, it has been featured on YouTube in both English and Spanish, and has seen users from places all around the world. For a solo developer like myself, it has been amazing. I want to sincerely thank you all for your support!

Thank you!

~ Jon from Firstfruits Studio
Hi, everyone!

This update adds the following Bible translations to the free online version of Bible Plugin for OBS Studio:
  • Louis Segond (LSG) [French]
  • Reina-Valera Antigua (RVA) [Spanish]
Surprisingly, analytics show that the website has had quite a number of users especially from Spanish-speaking countries. As a result, I added these two public domain Bibles to the free online version, in addition to the King James Version.

Please note that I personally do not speak either French or Spanish. Based on my limited testing, though, I think they work all right. If you do speak any of these languages, feel free to let me know if there are any issues. For now, these Bibles should be considered experimental.

This update does not change anything for the Coffee Version, so there is nothing new to download. Users of the Coffee Version can already download and use any supported Bible translation, including the Bibles above. (For reference, the two Bibles above were taken from Zefania.) If there is enough interest, though, I'll add both Bibles to the Generator program directly in a future update so you won't have to download them from another website.

Thank you for reading and have a nice day!

Louis Segond (LSG) [French]
2021-11-02 Genesis 1-1 LSG.png


Reina-Valera Antigua (RVA) [Spanish]
2021-11-02 Genesis 1-1 RVA.png
Hi, everyone!

Version 1.2.5 of Bible Plugin for OBS Studio has been released.

Changelog
  • Fixed a bug when Bible translations had missing verse numbers. Before, when searching for a Bible chapter with a missing verse, the entire chapter would not load. Now the issue has been fixed so everything should work normally.

Important Notes
  • Please backup your verse list and custom themes before updating.

Update Guide

Online Version

For the online version, you don't have to do anything. You will automatically be updated to the latest version the next time you use the plugin.

Coffee Version
  1. Download the latest version from Payhip.
  2. Close OBS Studio.
  3. Open the Generator program and choose the same Bibles and same output folder.
  4. Reopen OBS Studio. You should be on the latest version.

Checking Your Version

To check your version, go to Settings and scroll to the bottom. Your version information will be there.

2021-11-01 Check Version.png
Hello, everyone!

I would like to announce that the Coffee Version of Bible Plugin for OBS Studio has been released! It is now available for purchase here:

https://payhip.com/b/9POoJ

The product page also has information on system requirements and other important stuff.

Features of the Coffee Version:
  • Custom Bible translation support. Choose from one of five public domain Bibles. Or, use your own. The program supports reading Bibles imported into OpenLP.
  • Use beautiful premium themes. Some of them are even animated!
  • Offline usage. No Internet connection is required (except for optional Google Fonts support).
  • Create new themes and customize existing ones using Cascading Style Sheets (advanced feature, for developers only).
I would like to extend my thanks to everyone who commented, left reviews, or messaged me directly with questions. I am grateful to you all!

Going forward, I plan to continue updating and tweaking the plugin. Please feel free to get in touch if you have an idea, suggestion, or bug report.

Once again, thanks! God bless!
Top