Install on Linux
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
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/
Below is one of the options we tested:
sudo apt install -y make build-essential python3 python-setuptools python3-pip python3-dev python3-venv libssl-dev libffi-dev libnss3 zlib1g-dev libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm libncurses5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev libffi-dev liblzma-dev
Read more at: https://github.com/pyenv/pyenv/wiki#suggested-build-environment
Get git ready! [optional]
There are different ways to download UBA, we use git in the following example.
To install git, run on terminal:
sudo apt install -y 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
Install tools and dependencies:
sudo pacman -Syu
sudo pacman -S gcc glibc wget git python-pip python-setuptools pyside2 pyside2-tools qt5-webengine python-pyqt5 python-pyqt5-sip python-pyqt5-webengine python-qtpy nano locate plocate lame vlc pulseaudio
Read more at: https://github.com/eliranwong/uniquebibleapp-webtop/blob/main/Dockerfile.aarch64 and https://github.com/eliranwong/uniquebibleapp-webtop/blob/1010a458121cb0f3ab6c64f403e74ddb83e58639/root/etc/cont-init.d/56-openboxcopy
You simply need to download and run. Everything else will be set up for you automatically the first time you run UBA.
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:
UBA should look like this screenshot below the first time you run it:
A desktop shortcut "UniqueBibleApp.desktop" is generated for you automatically the first time you run UBA.
The shortcut file is automatically copied to ~/.local/share/applications
You should be able to find it with gui Launcher, depending on what Linux distribution you use.
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
-
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:
chmod u+x $HOME/UniqueBible/uba.py
You may read more about WSL2 setup at:
https://github.com/eliranwong/wsl2/blob/master/bible_apps/desktop.md
For any installation issues, refer to Installation troubleshooting