Web Version [available OFFLINE]
You can run our desktop GUI version on Windows, macOS, Linux, ChromeOS, which supports Qt library.
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:
- 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.
- 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
- 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.
-
Download "Termux" from standard Play Store.
-
Open "Termux" app after installed.
-
Run the following commands on your Termux app to get everything ready:
pkg install root-repo
pkg install python
pkg install git
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
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:
-
Open a web browser
-
Enter url 'http://localhost:8080'
Option 1 - manual entry
-
Open a web browser
-
Enter url 'http://:8080'
(In our screenshot example above, the url is http://192.168.167:8080)
Option 2 - QR code
-
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.
-
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 can either:
- Use selection menu and chapter navigation buttons available on default layout
- Simply enter a passage, e.g. John 3:16, into the command entry. [Remarks: Abbreviations works, e.g. Jn 3:16.]
- Use Bible Navigation menu, described below.
You can open our web version bible navigation and search menu by clicking the '*' button.
With this menu, you can:
- open a bible version or a passage
- open a UBA feature or resource specifically related to the selected passage.
- search a bible / multiple bibles
From default layout, you can see a 'layout' button, click it to change to our 'mini' layout.
Our 'mini' layout is designed to be as mini as possible to save space for use on mobile devices.
To change back to default layout from 'mini' layout, either:
- enter '.layout' command
- click '?' button and click on '.layout' link to make a swap between available layouts.
There are two available themes, 'default' and 'dark'.
To do a swap between the themes, either:
- enter '.theme' command
- click '?' button and click on '.theme' link available on the help page
One unique feature of UBA desktop version is that users can enter a single line command to have quick access to biblical resources.
You can do the same with our web version by entering a command in the command input.
For example, the following screenshot is taken after running 'compare:::KJV_CUV:::Jn 3:16'.
For supported http-server built-in commands and UBA commands, read our help page by clicking the '?' button.
Click the '?' button for help page, which contains links to common features. There are annotations right next to available links. Therefore, you may use the help page as a menu for quick access of different UBA features.
It is highly recommended users read the help page to get familiar what the UBA app is up to.