Install on Windows - eliranwong/UniqueBible GitHub Wiki

Latest

For installing UBA on Windows via WSL2, read https://github.com/eliranwong/UniqueBible/wiki/Install-UBA-on-Windows-via-WSL2-Ubuntu

Set up "Unique Bible App" on Windows

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

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/

We found that it is pretty easy to install python and git ready with Chocolatey, so we will talk about chocolatey setup first.

Get chocolatey ready!

  1. Right-click Windows Icon, located at left lower corner

  2. Select and open "Windows PowerShell (Admin)"

  3. Enter the following command (copied from https://chocolatey.org/install):

Set-ExecutionPolicy Bypass -Scope Process -Force; iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))

Get python ready!

  1. Right-click Windows Icon, located at left lower corner

  2. Select and open "Windows PowerShell (Admin)"

  3. Enter the following command:

choco install python

refreshenv

Get git ready! [optional]

There are different ways to download UBA, we use git in the following example.

To install git,

  1. Right-click Windows Icon, located at left lower corner

  2. Select and open "Windows PowerShell (Admin)"

  3. Enter the following command:

choco install git

refreshenv

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/main.zip

ATTENTION!

INSTRUCTIONS ABOVE: Use "Windows PowerShell (Admin)" instead of "Windows PowerShell"!!!

INSTRUCTIONS BELOW: Use "Windows PowerShell" instead of "Windows PowerShell (Admin)"!!!

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.

FOR THE REST BELOW: Use "Windows PowerShell" instead of "Windows PowerShell (Admin)"!!!

  1. Right-click Windows Icon, located at left lower corner

  2. Select and open "Windows PowerShell"

To download:

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

To run:

python .\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:

Run from Power Shell

You can run UBA from Power Shell by entering either full or relative path of file "uba.py"

UniqueBible\uba.py

Desktop Application Shortcut

An application shortcut "UniqueBibleApp.bat" is generated for you automatically the first time you run UBA.

You can simply double-click it to run UBA.

Alternatively,

  1. Right click the file "UniqueBibleApp.bat" in the UniqueBible folder.

  2. Select "Send to > Desktop (create shortcut)"

  3. Rename the desktop shortcut "UniqueBibleApp.bat - Shortcut" to "UniqueBible.app"

  4. Right-click the shortcut file and select "Properties" (see screenshot at the bottom)

  5. Change Icon..., browse and select "UniqueBibleApp.ico" in folder "UniqueBible\htmlResources", i.e.:

%USERPROFILE%\Documents\UniqueBible\htmlResources\UniqueBibleApp.ico

Run with Desktop Shortcut

Double-click the created shortcut file.

Run without the black console

  1. Right-click the shortcut file and select "Properties"

  2. In "Target", add "RunNHide.vbs " before "UniqueBibleApp.bat". [please note that there is a space character " " after "RunNHide.vbs"]

In our example (see screenshot below), we change:

from

C:\Users\elira\UniqueBible\UniqueBibleApp.bat

to

C:\Users\elira\UniqueBible\RunNHide.vbs UniqueBibleApp.bat

  1. Select "Apply" to make changes effective.

Alternative

You may also install Unique Bible App webtop version on Windows, read:

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