Skip to content

Running telnet server on Android

Eliran Wong edited this page Sep 13, 2022 · 19 revisions

Running on Android

We now have an Android mobile app: https://github.com/eliranwong/UniqueBible/wiki/Android-iOS-Version. The current mobile version has much less functions than the desktop one. That's why we have a hybrid version to fill the gap, but the hybrid version is still under development.

If you like command line interface, you may consider running UBA desktop version on Android via an Android app called "Termux"

Running UBA telnet-server with Termux

"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

With Termux, you can simply run UBA telnet-server on Android devices. You may read below for setup and startup.

Setup of UBA telnet-server on Android

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

  2. Open "Termux" app after installed.

  3. Run the following commands on your Termux app to get everything ready:

pkg install root-repo

pkg install python

pkg install git

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

Startup of UBA telnet-server

Open Termux app 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 telnet-server & disown

(Note: use "& disown" above, to enable you to connect to the server on the same Termux session. Read more below.)

You should see:

Slow downloading

When starting for the first time, you might see it stuck on installing pygithub. It can take a long time for this to be installed. You can stop this by pressing the "CTRL" button then hit letter "C". Install the pygithub manually to see the status of install with "pip install pygithub". After pygithub is installed, start up UBA telnet-server with the above command.

Connect UBA

You can use the following command to connect UBA telnet-server on the same device.

telnet localhost 8888

Instead of using command line telnet, you can install an Android telnet program such as Termius

You can also access it from another computer/device by running:

telnet <ip> <port>

Automation & Shortcut

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

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

alias uba="telnet localhost 8888"

Run a command

e.g. Go to a passage

John 3

e.g. Change bible version

text:::NET

e.g. Open commentary

commentary:::John 3

e.g. search bible with regular expression

regexsearch:::Jesus.*?love

e.g. documentation of available commands

.help

Update UBA

Watch this project https://github.com/eliranwong/UniqueBible to get notification about update.

Use "git pull" to update

cd UniqueBible

git pull

Adding more resources

You can expand the library by adding resources to the folder "UniqueBible/marvelData"

More about UBA telnet-server

https://github.com/eliranwong/UniqueBible/wiki/Remote-CLI

Using ssh [OPTIONAL]

pkg install openssh

git clone [email protected]:eliranwong/UniqueBible.git

Clone this wiki locally