Skip to content

Install on Windows

Jump to bottom
Eliran Wong edited this page Mar 1, 2021 · 22 revisions

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 verion 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/master.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:

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"

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

%USERPROFILE%\Documents\UniqueBible\htmlResources\theText.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.
Clone this wiki locally