Skip to content
A cross-platform bible application, integrated with high-quality resources and amazing features, running offline in Windows, macOS and Linux
Python JavaScript CSS Other
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
htmlResources
marvelData Create Readme.md Feb 28, 2019
selectedVerses
testing testing file download and unzip Feb 12, 2019
thirdParty
BibleVerseParser.py
BiblesSqlite.py version 5.2; can customise data path Nov 11, 2019
LICENSE
Note.docx added buttons for interface Feb 22, 2019
NoteSqlite.py version 5.2; can customise data path Nov 11, 2019
README.md
TextCommandParser.py
TextFileReader.py added context menu to popover window Feb 15, 2019
ThirdParty.py version 5.2; can customise data path Nov 11, 2019
ToolsSqlite.py
Twwy.py updated Jul 18, 2019
UniqueBibleAppVersion.txt
downloadButton.png
gui.py
install.sh
main.py version 5.2; can customise data path Nov 11, 2019
note_editor_key_combo.uba added key bindings for note editor Feb 9, 2019
notes.html
notes.uba
screenshot.png
shortcut_uba_Linux.desktop
shortcut_uba_Windows.bat Add files via upload Nov 2, 2019
shortcut_uba_macOS_Linux.sh Update shortcut_uba_macOS_Linux.sh Nov 2, 2019

README.md

Looking for Android / iPhone / iPad versions?

We have recently launched our mobile versions in Google Play Store and Apple App Store.

Illustrated User Manual: https://www.uniquebible.app/mobile
Links for downloads: https://www.uniquebible.app/download

UniqueBible

A cross-platform & offline bible application, integrated with high-quality resources and unique features.

Tested in: Windows, macOS and Linux (Ubuntu & Mint)

(developed with Python [version: 3.7.2])

Visit https://BibleTools.app for further information.

Pre-requisite

The "desktop" version of "UniqueBible.app" is programmed with python library. Users have to install python library first in order to run "UniqueBible.app" on your desktop OS.

Go to https://www.python.org for instructions on installation of python for FREE.

Install Dependencies

pip3 install PySide2
(PySide2 is required for graphical user interface, used by UniqueBible.app.)

pip3 install PyPDF2
(PyPDF2 is required for reading text from *.pdf documents.)

pip3 install python-docx
(python-docx is required for reading text from *.docx documents.)

pip3 install gdown
(gdown is required for downloading database files stored in google drive.)

If you use use Anaconda python distribution, use the following commands instead to install dependencies:

conda install -c conda-forge pyside2
conda install -c vladsaveliev gdown
conda install -c conda-forge pypdf2
conda install -c conda-forge python-docx

Download & Run UniqueBible.app

Click on the download button on this page to download a zip copy of this repository, i.e. "UniqueBible-master.zip".

Example: Install & Run on macOS / Linux

  1. Use the download button on this page to download a zip copy.
  2. This example assume that your downloaded file is located in "Downloads" of your home directory, i.e. ~/Downloads/.
  3. Open terminal and enter all the following commands:
    cd ~
    unzip ~/Downloads/UniqueBible-master.zip
    cd UniqueBible-master
    python3 -m venv venv
    source venv/bin/activate
    pip3 install PySide2
    pip3 install PyPDF2
    pip3 install python-docx
    pip3 install gdown
  4. To run the app that installed with the previous 3 steps, enter the following command in terminal:
    python3 main.py

Example: Install & Run on Windows

  1. Use the download button on this page to download a zip copy.
  2. Unzip the downloaded file "UniqueBible-master.zip" into a folder, e.g. "c:\UniqueBible-master"
  3. Open command prompt and enter all the following commands:
    python -m venv c:\UniqueBible-master\venv
    cd c:\UniqueBible-master
    .\venv\Scripts\activate
    pip3 install PySide2
    pip3 install PyPDF2
    pip3 install python-docx
    pip3 install gdown
  4. To run the app that installed with the previous 3 steps, enter the following command in terminal:
    python3 main.py

Example: Install & Run on Chrome OS

  1. Enable Linux apps: Open your Chrome OS Settings app, find “Linux Apps” and click “Turn On“. Your Chromebook will download the required files to use Linux apps. When complete, a new Terminal app will open.
    To get the latest update, in Linux terminal, enter:
    sudo apt udpate
    sudo apt full-upgrade
  2. Make sure you have "wget" installed, by running the following commands in Linux terminal:
    sudo apt install wget
  3. Make sure you have "python" library & tools are in place:
    sudo apt install python3
    sudo apt install python3-setuptools
    sudo apt install python3-pip
  4. Install dependencies for this app, enter the following command:
    pip3 install --user PySide2
    pip3 install --user PyPDF2
    pip3 install --user python-docx
    pip3 install --user gdown
    [Remarks: In our testings, command "pip3 install PySide2" encounters memory errors on some low-memory chromebooks. You may install wheel from Qt servers with this command instead:
    pip3 install --index-url=https://download.qt.io/official_releases/QtForPython/ pyside2 --trusted-host download.qt.io
    Reference: https://wiki.qt.io/Qt_for_Python/GettingStarted]
  5. Export PATH
  • temporary solution - enter this command in terminal:
    export PATH=$PATH:$HOME/.local/bin
  • permanent solution - add the following line at the end of file ".bashrc" in the home directory:
    export PATH=$PATH:$HOME/.local/bin
    [close and re-open the Linux terminal after saving the changes in file ".bashrc"]
  1. Download the app in a zip file, enter in terminal:
    cd ~
    wget https://github.com/eliranwong/UniqueBible/archive/master.zip
    unzip master.zip
    cd UniqueBible-master
  2. Run the app, enter in Linux terminal:
    cd ~/UniqueBible-master/ && python3 main.py
  3. Create a shortcut for use in terminal, add the following line at the end of file ".bashrc" in the home directory:
    alias uba="cd ~/UniqueBible-master/ && python3 main.py"
    [close and re-open the Linux terminal after saving the changes in file ".bashrc"]
  4. Run the app with shortcut in terminal:
    uba
  5. Create a shortcut in application menu [so you don't need terminal to run the app]
    First, edit file "~/UniqueBible-master/shortcut_uba_Linux.desktop", by replacing username "eliranwong" with your username.
    Second, run the following command in Linux terminal:
    sudo mv ~/UniqueBible-master/shortcut_uba_Linux.desktop /usr/share/applications/UniqueBibleApp.desktop
    Locate the created shortcut in folder "Linux apps" of chrome application menu.
    [To read more about .desktop file: https://developer.gnome.org/integration-guide/stable/desktop-files.html.en]

Creating a Shortcut

There are various ways to create a shortcut, below are some examples:
For macOS / Linux: https://github.com/eliranwong/UniqueBible/blob/master/shortcut_uba_macOS_Linux.sh
Linux / Chrome OS: https://github.com/eliranwong/UniqueBible/blob/master/shortcut_uba_Linux.desktop
Windows: https://github.com/eliranwong/UniqueBible/blob/master/shortcut_uba_Windows.bat
Remarks: Change paths in the files above according to where you place the app's folder on your devices.

Where are the Database Files?

All codes for running the app is shared in this repository.

Github has restrictions on upload size. For this reason, full set of database files is not able to be uploaded here.

To run UniqueBible.app and its features, several database files are required. To help you about installing particular datasets, "Download Helper" comes up automatically, when a database file is needed for a particular feature.

You can also manually install "ALL" https://marvel.bible datasets via our menu bar.
Go to "Resources" > "Install Marvel.bible Datasets"

Remarks: It takes time for large files to be downloaded. The core datasets for running UniqueBible.app is 49MB in size. You may need to wait for a while for downloading it after you first launched UniqueBible.app.

In ADDITION to official UniqueBible.app data, we support various 3rd party modules. Please see below for details.

Screenshot:

3rd Party Resources

In addition to Marvel.bible modules and datasets, UniqueBible.app has a built-in converter.
The built-in converter supports import of the following third-party modules:

Users need to download 3rd party modules separately.

Built-in converter can be accessed via our menu bar:
Go to menu "Resources" > "Import 3rd Party Modules"
For import of multiple files in one go:
Put 3rd party modules, which you want to import, in a folder.
Go to menu "Resources" > "Import Supported 3rd Party Modules in a Folder"

Disclaimer: All third-party modules are created by third parties. UniqueBible.app does not endorse any particular theological views or individual content of these 3rd-party modules. Please contact individual module creators or parties if you have issues with their content. UniqueBible.app is NOT responsible for any third-party modules in terms of their quality or content. Users should only use these third-party modules with their own judgment and at their own risks.

Donations:

Please consider a donation via our PayPal account: https://www.paypal.me/MarvelBible

You can’t perform that action at this time.