Installation

Recommendations

There are several different ways to install Unique Bible App. We would like to give you a quick overview on what are the easiest way on each platform, in our opinion:

Windows - use of choco makes UBA installation in Windows straightforward, read:

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

macOS (version 10.15 or newer with Intel chip) - webtop version is better unless you know very well how to manage python library, packages and dependencies on macOS. For webtop version, read:

https://github.com/eliranwong/UniqueBible/wiki/Webtop-Version---RECOMMENDED

macOS (Apple chip, e.g. M1) - definitely webtop version is the best option, read:

https://github.com/eliranwong/UniqueBible/wiki/Webtop-Version---RECOMMENDED

Chrome OS - web version can save you time from installing decencies yourself, read:

https://github.com/eliranwong/UniqueBible/wiki/Webtop-Version---RECOMMENDED

though direct setup of UBA in ChromeOS Linux container is not difficult:

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

News! Unique Bible App Webtop Version

Simple to install! Great for Bible Study!

Read more at: https://github.com/eliranwong/UniqueBible/wiki/Webtop-Version---RECOMMENDED

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

1. Install Python3

2. Download UBA

3. Run UBA

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:

1. Set up a virtual environment to run UBA, so to avoid any potential conflict with other python-based software / projects on your device.

2. Install all dependencies required (listed at: https://github.com/eliranwong/UniqueBible/blob/main/requirements.txt)

3. Create application shortcut

4. Download initial content

5. 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.

Read more: https://github.com/eliranwong/UniqueBible/wiki/Third-party-resources

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