-
-
Notifications
You must be signed in to change notification settings - Fork 35
Install on macOS
Simple to install! Great for Bible Study!
https://github.com/eliranwong/UniqueBible/wiki/Webtop-Version---RECOMMENDED
The have pack everything you needed to run Unique Bible App in our webtop version. MacOS with Intel and Apple chip, e.g. M1, are supported.
The notes below were written for technical users some time ago. If they do not work for you, you may try our webtop version just mentioned above.
Basically, you simply need to download UBA and run it if you have Python and git in place.
Steps to set up for a fresh installation:
-
Install Python and git
-
Download UBA
-
Run UBA
macOS Sierra (version 10.12) or later
https://github.com/eliranwong/UniqueBible/wiki/Install-UBA-on-macOS-with-Latest-M1-Chip
https://github.com/eliranwong/UniqueBible/wiki/Install-UBA-on-macOS-Big-Sur-with-Intel-Chip
There is a known issue of running python under macOS Big Sur + Xcode.
We have a tested example on installing UBA on macOS Big Sur:
https://github.com/eliranwong/UniqueBible/wiki/Install-UBA-on-macOS-Big-Sur
Setup and maintenance of UBA are more consistent across difference macOS versions through webtop:
https://github.com/eliranwong/UniqueBible/wiki/Install-on-Arch-Linux-Webtop
If none of the methods mentioned on this page work for you, you should try webtop. Notes in the above link is written especially for macOS users.
Get python ready!
UBA is a python-based application, so you need to have Python installed to run UBA.
Minimum Python version for running UBA: 3.7
There are several different ways to install Python, read more information at: https://www.python.org/downloads/
Get git ready! [optional]
There are different ways to download UBA, we use git in the following example.
To install homebrew, run on terminal ("Applications > Utilities > Terminal.app"):
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
To install git with homebrew, run:
brew install git
Don't want to use git? You can download a zip package of UBA and unzip it instead of using git:
https://github.com/eliranwong/UniqueBible/archive/master.zip
You simply need to download and run. Everything else will be set up for you automatically the first time you run UBA.
This means that you only need to enter 2 command lines on macOS terminal ("Applications > Utilities > Terminal.app").
To download:
To run:
python3 UniqueBible/uba.py
A screenshot is provided here, so you may know what to expect during the first-time setup:
![](https://github.com/eliranwong/UniqueBible/raw/master/screenshots/mac_download_and_run.png)
UBA should look like this screenshot below the first time you run it:
![](https://github.com/eliranwong/UniqueBible/raw/master/screenshots/mac_1st_screen.png)
A desktop shortcut "UniqueBibleApp.sh" is generated for you automatically the first time you run UBA.
The shortcut file added to your UniqueBible directory.
On mac, right click the file UniqueBibleApp.sh, select "Get Info".
![](https://github.com/eliranwong/UniqueBible/raw/master/installation/screenshots/mac_shortcut1.png)
In the section "Open with:", select "Terminal.app" as default.
![](https://github.com/eliranwong/UniqueBible/raw/master/installation/screenshots/mac_shortcut2.png)
Now, you can double-click the file "UniqueBibleApp.sh" to run the app directly.
You can run UBA with terminal without typing a fullpath, by creating an alias.
Below is an example:
This example only works if:
-
You use bash (for example, if you use "zsh" on macOS, you need to change "
/.bashrc" to "/.zshrc") -
The following example assumes that you install UBA in your home directory. You need to change the path if you install at a different location.
echo "alias uba='$HOME/UniqueBible/uba.py'" >> ~/.bashrc
Close and reopen your terminal app, you should then be able to run UBA with this simple command:
uba
Our setup script automatically makes file "uba.py" executable, but in case it is not running, you may need to set permission on it manually:
[Edit the path of UniqueBible if it is not installed in your home directory!]
chmod u+x $HOME/UniqueBible/uba.py