Skip to content

Install on Linux

Eliran Wong edited this page Aug 26, 2023 · 21 revisions

Set up "Unique Bible App" 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:

  1. Install Python and git

  2. Download UBA

  3. Run UBA

Prepare for Installation [Ubuntu / Debian]

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

Extra notes for Ubuntu users:

https://github.com/eliranwong/UniqueBible/wiki/Install-UBA-on-Windows-via-WSL2-Ubuntu#install-basic-library-and-tools

Prepare for Installation [Arch Linux]

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

Download UBA & Run

You simply need to download and run. Everything else will be set up for you automatically the first time you run UBA.

To download:

git clone https://github.com/eliranwong/UniqueBible

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:

Desktop Application Shortcut

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.

Create a command alias [optional]:

You can run UBA with terminal without typing a fullpath, by creating an alias.

Below is an example:

This example only works if:

  1. You use bash

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

Extra information on Windows Subsystem for Linux (ver 2)

You may read more about WSL2 setup at:

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

Installation troubleshooting

For any installation issues, refer to Installation troubleshooting

Clone this wiki locally