Chrome extension to for Bible.com

This extension will help you project Bible verses in your Church, You decide which version to display and also can project parallel versions or in 2 different languages.

Table of Contents

• 💠 Features & Usage
• 📈 Release Notes
• 🎞 Results
• ⚙ Install Plugin
  • 🎫 QR Code
• 👋 Support my Work
• 💠 Advanced Features
• ⚙ Setup Plugin as Developer
• ▶ Build procedure
• 📋 Developers TODOs (items to improve)

💠 Features & Usage

• 🔤 Project selected verses (+/- parallel text)
  • 🔎 Search Book and Chapter
  • Click on verse number to display it on projector
  • Up / Down / Left / Right arrows to navigate to next/preview verses
  • CTRL + Click to add verse to selection (multi select)
  • Shift + Click to multi select between last selection
  • ALT + Click on verse number or Pinned reference, to force project window to be on top (in case is not visible)
  • ESC to show blank page (hide all selected verses)
  • F11 to enter/exit fullscreen projector window (first focus it)
• 💬 Project "live text" (fast and simple slide)
  • input any text to be projected (Markdown format)
  • CTRL + Enter to project live text (inside title or textarea)
  • Select any text from page and allow it to be projected
• 📌 List/Pin some references (verses)
  • Store references for future selection and project them faster
  • Enter to add references (, or ; as separator) in Pin verses 🔍 input
  • Enter + Enter to project added reference
  • Shift + Enter to add and project full reference (Mat 6:7-13)
  • ALT + Click on Reference - force project (on top)
  • CTRL + Click project all verses from pin (Mat 6:7-13)
  • 📝 Edit All to Copy/Paste/Edit multiple references
  • ➕ will pin current Reference if search input is empty
  • 'Search pin': 16, 2-4, 2:4, 2 4, +Enter - pin current chapter or verses
  • ↕ drag & drop to reorder verses
  • 🖱 Context menu (right click) for more actions inside pin list
    • 📄 Copy selected verse to clipboard
    • 📄 Copy all pin verses to clipboard
    • ✖ Clear all
  • Change Reference 🔍 from Projector tab - works same as Add Ref's 🔍
    • Tab inside projector tab to see bottom dock-bar
    • 🖱 move mouse at the bottom edge of projector tab
    • Type any reference and use same shortcuts to project it (Enter or Shift + Enter for multiple verses)
• 2️⃣ open Multiple chrome tabs with different chapters
  • all windows will project to the same projector page
  • projector page will close only when all tabs from my.bible.com are closed
• 🛠 User Settings (top-left actions)
  • Toggle 1️⃣ primary OR 2️⃣ parallel verses to be projected
  • Adjust css variables (spacing, colors)
  • remember last windows position (projector & settings)
  • ☽ Try Night mode extension

📈 Release Notes

Check release-notes.md changelog

💚 Love this extension? Share feedback and help us make it even better!

🎞 Results

1️⃣ Primary View + projected

2️⃣ Parallel View + projected

💬 Actions

🛠 Settings

⚙ Install Plugin

• ✔ Install Chrome plugin from Chrome web store Project verses from bible.com
• visit https://my.bible.com/bible or https://my.bible.com/sign-in
• new actions (💬, 🛠, ❔, 📌) should be visible in top/left corner
• 📌 Pin extension to see it after search bar for fast access
  • Click on Extension icon

🎫 QR Code

bit.ly/project-bible

👋 Support my Work

A simple way to support my work & to improve your programming skills is to buy My course on Udemy. (Or you can Gift this course to someone that will benefit from it).

• ‍💻 Become a WEB Developer from Scratch, step by step Guide - by Nicolae Matei

💠 Advanced Features

• 🛠 User Settings
  • 🕒 Clock position (or hide)
  • hide/show arrows (actions) from projecting screen
  • Upload multiple background images and allow to easy switch them
  • Background Opacity (make image lighter or darker)

⚙ Setup Plugin as Developer

If you want to try the latest versions before they are released, or to change code as you wish, try to install it as Developer

• Download/Clone this repo
  • as zip & Unzip it
  • or git clone https://github.com/nmatei/chrome-bible-utilities.git
  • to update use git pull
• Open chrome://extensions/
  • Activate Developer mode
• Load unpacked Extension
• Select chrome-bible-utilities folder

▶ Build procedure

• make sure all files are commited and pushed
• npm install
• npm run deploy
• under /build folder you will find latest zip file
• upload it to chrome web store

📋 Developers TODOs (items to improve)

• Context menu on verses number (right click)
  • Project verse
  • Add verse to project list
• Check if verses are not in sync
  • Available Language mappings and version
    • Russian (НРП/СИНОД/SYNO/CARS/CARS-A)
    • Ukrainian (UBIO)
  • Review Translations and create other mappings
    • Especially for 🟨🟦 Ukrainian & ⬜🟦🟥 Russian
    • 🙏 mappings tests
    • 🙏 need some external help here (if you find issues please create a tiket with link you've seen)
• 🛠 User Settings
  • Allow to easy select font family from drop down (or add your own)
  • Allow reordering of slides master layouts
  • Add config for body / verses text shadow.
  • Allow to display on 2 different screens (primary => Screen 1, parallel => Screen 2)
  • Allow display inline/block for main screen
  • Empty Text display (ex. Church name, verse, motto, etc.)
    • Customize size & color
• Add WebHooks configs (ex. to publish to wireless monitors)
  • create integration app that can be installed
• i18n
• cleanup chars when add ref from copy/paste
  • ‭‭Filipeni‬
• use TypeScript and a build system?
  • https://medium.com/@tharshita13/creating-a-chrome-extension-with-react-a-step-by-step-guide-47fe9bab24a1

🐛 Known bugs

• https://www.bible.com/bible/191/EXO.15.VDC (v.2 - custom background color in dark mode - text not fully visible)