Installation - eliranwong/UniqueBible GitHub Wiki

For Non-technical Users

For non-technical users who do not want to handle command-line tools, we provide step-by-step guide for installing Unique Bible App on Windows and macOS without any command entry.

For Technical Users

For technical users, who are comfortable to handle command line tools, please read instructions below.

Unique Bible App desktop version also runs on Linux and ChromeOS, please read links below.

Our Recommendations

Even on a single operation systems, there are various different ways to get Unique Bible App installed. This may make it difficult for new UBA users to choose an installation method. To help you start it quick, we give our recommendations for different platforms at:

https://github.com/eliranwong/UniqueBible/wiki/Recommendations-for-Different-Platforms

You may want to check the link given above before you go through notes below, some of which were written some time ago.

News! Unique Bible App Webtop Version

Simple to install! Great for Bible Study!

Installing Unique Bible App

The installation instructions presented below were written for technical users. If these notes below does not work for you, you may take a look at our newly released webtop version, which is mentioned above.

Steps

Install Python3

If you can run 'python3', then it is already installed. Make sure it is at least version 3.7 by running python3 -V.

Download and install Python3

Download UBA

Download zip:

https://github.com/eliranwong/UniqueBible/archive/main.zip

Then unzip it.

If you want to use git instead, see Using Git

Install and run UBA

UniqueBible/uba.py (if used git) or UniqueBible-main/uba.py (if downloaded zip)

uba.py will perform the following:

Set up a virtual environment to run UBA, so to avoid any potential conflict with other python-based software / projects on your device.
Install all dependencies required (listed at: https://github.com/eliranwong/UniqueBible/blob/main/requirements.txt)
Create application shortcut
Download initial content
Special tweaks for particular platform, e.g. Linux, Chrome OS

One-off automatic setup is performed the first time you run UBA.

Download resources

Subsequent download of resources is based on your demand.

When you select a new feature, UBA asks you if you want to install extra resources in case some files are not yet installed.

You can also import tons of third-party resources, created for many different third-party softwares in Unique Bible App.

Therefore, you can have all the best resources centralised in UBA.

Examples on different platforms:

Windows

https://github.com/eliranwong/UniqueBible/wiki/Install-on-Windows

macOS

https://github.com/eliranwong/UniqueBible/wiki/Install-on-macOS

Old macOS

https://github.com/eliranwong/UniqueBible/wiki/Install-on-Old-macOS

Linux:

https://github.com/eliranwong/UniqueBible/wiki/Install-on-Linux

Chrome OS:

https://github.com/eliranwong/UniqueBible/wiki/Install-on-Chrome-OS

Windows Subsystem for Linux (version 2):

https://github.com/eliranwong/wsl2/blob/main/bible_apps/desktop.md

Running telnet-server on Android device

https://github.com/eliranwong/UniqueBible/wiki/Running-telnet-server-on-Android

Web Version

Web version runs on all platforms with a web browser. It is able to run OFFLINE too.

https://github.com/eliranwong/UniqueBible/wiki/Web-Version-%5Bavailable-OFFLINE%5D

Installation issues

If you have any installation issues, please first refer to Installation and startup issues. If that does not address it, please create a new issue.