You can run our Web version on any devices which has a web browser. Offline running is supported.

It may be a good choice especially if you want to want the full UBA on your mobile devices. Read more below.

There are several options to run UBA on Android devices:

1. Native Mobile App.

• Pros: Easy to be installed via Play

• Cons: Resources are bundled but not extensible. Much less features than the full UBA desktop features.

• Read more at: https://github.com/eliranwong/UniqueBible/wiki/Android-iOS-Version.

2. Hybrid Version

• Pros: Written as a cross-platform native app, designed to be extensible in terms of resources.

• Cons: Still in development, may be postponed indefinitely due to new development of Web Version [described below].

• Read more at: https://github.com/eliranwong/UniqueBibleAppHybrid

3. Web Browser Version

• Pros: Use the same resources and codes as the UBA desktop version. Can run offline on your mobile devices. Install on one device and access from any kinds of devices having a web browser. For example, run a copy on an Android phone, and give everyone in the same room to use the app.

• Cons: Need a third-party app, e.g. Termux or iSH, to run UBA as a http-server.

The rest of this page describe how to set up UBA as a http-server on Android / iOS devices and run with a web browser.

"Termux is an Android terminal emulator and Linux environment application that works directly with no rooting or setup required." Read more about Termux at: https://wiki.termux.com/wiki/Main_Page

"iSH is a project to get a Linux shell environment running locally on your iOS device, using a usermode x86 emulator." Read more at: https://ish.app/

With Termux or iSH, you can simply run UBA http-server on mobile devices.

Remarks: There are several other options on Android, we recommend Termux for its simplicity.

https://github.com/eliranwong/UniqueBible/wiki/Running-UBA-server-on-iOS

There is a known issue that iSH is slows for database access.

1. Download "Termux", read: https://github.com/eliranwong/UniqueBible/wiki/Install-Termux-on-Android

2. Open "Termux" app after installed.

3. Download UBA:

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

Open Termux and run:

Remarks: It takes time for one-off automatic setup the first time UBA is launched. UBA should start up much faster after the first run.

cd UniqueBible

echo "pydnsbl" >> "disabled_modules.txt"

python uba.py http-server & disown

(Note: We use "& disown" here so that the opened terminal session won't be prevented from new input.)

You should see something like this screenshot for the first run:

1. Open a web browser

2. Enter url 'http://localhost:8080'

Option 1 - manual entry

1. Open a web browser

2. Enter url 'http://:8080'

(In our screenshot example above, the url is http://192.168.167:8080)

Option 2 - QR code

1. Generate a QR code from the device which has the UBA http-server running, by running '.myQRcode' command or click the '.myQRcode' link on help page.

2. Use a QR code scanner from a client-device to scan the QR code to make connection.

You can use UBA web version both offline and online.

To use the web version offline, simply install UBA on your device (mobile, laptop or desktop) and access it with a web browser using http://localhost:8080

To share the installed app with other users. For example, you have your UBA installed on your phone, bring it to a bible study group, and inform others to connect to UBA on your phone using your phone ip or QRcode.

You may place the following line in file '/data/data/com.termux/files/home/.bashrc':

python /data/data/com.termux/files/home/UniqueBible/uba.py http-server & disown

There are various ways to achieve this, below is an example:

(reference: https://wiki.termux.com/wiki/Termux-setup-storage)

1. Run in Termux:

termux-setup-storage

2. Select "Allow" to allow Termux to access phone storage

3. Connect laptop to an Android phone with a USB cable

4. Enable USB file transfer on your Android phone

5. Copy marvelData folder to, for example, "downloads" folder

6. Run in Termux:

cd ~

cd UniqueBible

mv marvelData marvelData_init

mv ~/storage/downloads/marvelData/ .

English - https://www.uniquebible.app/web/english-manual

https://github.com/eliranwong/UniqueBible/wiki/Set-up-bible-audio-on-Http-server

If you run an UBA http-server for multiple-users, it is better to set both config.developer and config.webFullAccess to False for security reasons.

Otherwise, users can run _setconfig:::enableCmd:::True, which can cause trouble.

Or any users may stop your server at anytime if you set either config.developer or config.webFullAccess to True.

To check user-ip against spam database, login in with administrative rights, run the following command and restart the server once:

_setconfig:::enableHttpRemoteErrorRedirection:::True

The value of config.enableHttpRemoteErrorRedirection is set to False by default. Therefore, developers need to manually enable it for public server.