README

This script opens a specific bible chapter or verse on the website www.bible.com.

Installation

1. ⬇️ Clone or download the repository to a local directory.
2. 📁 Navigate to the directory containing the script.
3. 📝 Edit the config.cfg file with your preferred language and translations.
4. 📝 Add a config_xx.cfg file if you want to add a new language setting (see Edit config files below).
5. 👨🏽‍💻 Add the following alias to your shell configuration file (Replace /usr/bin/python with the path to your Python interpreter and /path/to/script with the path to the script directory.):
   • Bash (add to ~/.bashrc): alias bible='/usr/bin/python3 /path/to/script/bible_com.py'
   • Zsh (add to ~/.zshrc): alias bible='/usr/bin/python3 /path/to/script/bible_com.py'
   • Windows (add to $PROFILE): Set-Alias -Name bible -Value 'python3.exe C:\path\to\script\bible_com.py'
6. 🆕 Reload your shell configuration or open a new terminal.

ℹ️ Windows Users:
In Windows, the PowerShell profile file is located at $PROFILE.CurrentUserAllHosts. You can edit this file to add the alias as described above.
Not tested in windows yet.

Usage

The script requires the following arguments:

bible_com.py [-h] [-t TRANSLATION] [-p PARALLEL] book chapter [verse]

Open Bible verses in web browser.

positional arguments:
  book                  Name of the book - can be upper or lower case, also just the beginning of the book name (e.g. 'heb' for Hebrews)
  chapter               Chapter number
  verse                 Verse number

options:
  -h, --help                      show this help message and exit
  -t TRANSLATION, --translation   TRANSLATION Translation version
  -p PARALLEL, --parallel         PARALLEL Translation for parallel view

Examples

# Open Genesis 1
bible gen 1

# Open John 3:16 in the ESV translation
bible john 3 16 -t esv

Edit/Add Config Files

config.cfg

The config.cfg file contains in the langages (de, en, es, ...) and translation sections. Depending on the keys in the language config, the config_xx.cfg file is loaded as well.

For the translations the name of the translation and the id from bible.com is needed.
Example:

[translations]
esv=59
elberfelder=2351

The key is used later in the command line argument for -t or -p. The values can be looked up on the url from bible.com after choosing the right translation.

config_xx.cfg (Multilanguage)

In the config_xx.cfg you have the books sections depending on the language you want to use. In the books section you define the book names with the aliases used by bible.com in the URL. Example:

[books]
jesaja=ISA
jeremia=JER