Install UBA on macOS

This wiki page describes how to install Unique Bible App on macOS.

The set up method given below are written for non-technical. With this method, users do not require typing any command line entry, but it may takes a few more steps, when compared with methods running with command lines. Technical users may also read command-line installation methods at https://github.com/eliranwong/UniqueBible/wiki/installation

Instructions below do not require command entry:

Step 1) Download and install Python Library

Step 2) Download the UBA zip package and Unzip

Step 3) Create a shortcut file

Step 4) Double-click the created shortcut file

Step 1 - Download and install Python Library

Go to https://www.python.org/downloads/ to download official python installer:

Locate the downloaded file in the "Download" directory:

Double-click to install Python Library

Step 2 - Download the UBA zip package

Click the link below and download:

Unique Bible App zip package

Please note that it may take a while, do not close your web browser before the zip package is completely downloaded.

When the package is completely downloaded, you can find it unpacked in "Download" directory.

You may want to move the UBA folder "UniqueBible-main" to where you want to store it, e.g. Desktop

Step 3 - Create a shortcut file

Inside the downloaded folder, locate file "uba.py" and right-click and select "Python Launcher" of the latest python version you installed in the step above.

At first, it does nothing, because you need to lift off security restriction before you can create a shortcut file with this method.

Open macOS "System Preferences", enter "security" to filter out available options. Select "Security & Privacy".

As you can see from the following screenshot, "uba.py" was blocked ...

Simply select "Open Anyway".

Then, select "Open"

Open the file "uba.py" again with "Python Launcher" of the latest python version you installed in step two.

After you see "Process completed", you should see a new file "uba.sh" is created in the same folder.

The "uba.sh" is the file, which we would use to run Unique Bible App on macOS.

Step 4 - Launch Unique Bible App

Right click the file "uba.sh" (NOT "uba.py") and select "Open With" > "Other"

Select directory "Applications" and double-click to open "Utilities".

Change "Recommended Applications" to "All Applications".

Select "Terminal".

Select "Always Open With"

Select "Open"

In the first run, Unique Bible App automatically install all required and featured packages for users. Therefore, the first run takes more time than a regular setup.