ub4tg/installing-on-termux.md

Termux apk here: https://f-droid.org/repo/com.termux_1020.apk  
Termux:API apk if you want get notifications about updates of this code: https://f-droid.org/repo/com.termux.api_51.apk  
  
System requirements:
Android 7+ and at least 500 Mb - 5 GB on storage, is official requirements from their wiki https://wiki.termux.com/wiki/FAQ#What_are_system_requirements  
Personally I recommend also:  
* 1.5 GB in storage is minimum for good perfomance, do not continue, if you have small storage, because it cause "no enough space" error
* arm64 proccessor and 64-bit OS, because on S1S13AF7 smartphone (Redmi 6A) have perfomance issues with 32 bit system, but maybe if install PostmarketOS on this smartphone it will be better because is more native Linux system than java wrapped Termux... Maybe also MIUI firmware issues
Anyway if you have low-end device, in step 1 when copying oneliner skip part with 'pkg update && pkg upgrade', but no any warranty, it can broke bot without upgrade Termux bootstrap packages. Also if your speed downloading updates very slow, press Ctrl+C, and try run `termux-change-repo` and select other region.  


0. Optional step: allow permission on storage in Termux before start, after this, step 3-4 can be skipped
1. Run termux and enter this oneliner:  
`pkg update && pkg upgrade && pkg install openssl python3 git termux-api && git clone https://code.criminallycute.fi/bioeb_org/ub4tg/ && cd ub4tg && pip3 install -r requirements.txt`  
If pkg upgrade ask overwrite some files - press Y
2. Now after this you can run bot:  
`./run` or `python3 ubot.py`
3. Termux will ask permission on storage, allow it. Restart Termux (enter `quit` or press CTRL+d)
4. Run bot again:  
`cd ub4tg; ./run`
5. Follow first time setup, it creates config for you and asks some questions
6. Enjoy
7. If you get some warnings about future events: sync your time in Android settings "date and time" and switch "network time" off/on

For start bot again (if Termux restarted) just enter:  
`cd ub4tg; ./run`  
For fast access to bot, make alias:  
`echo "alias ub4tg='cd ~/ub4tg; ./run'" >> .bashrc`  
then  
`source ~/.bashrc`  
Now you can run bot in everywhere directory, just enter: `ub4tg`
installing on termux instruction 2024-12-18 20:27:55 +02:00			`Termux apk here: https://f-droid.org/repo/com.termux_1020.apk`
			`Termux:API apk if you want get notifications about updates of this code: https://f-droid.org/repo/com.termux.api_51.apk`
system requirements for termux 2024-12-19 11:43:51 +02:00
			`System requirements:`
			`Android 7+ and at least 500 Mb - 5 GB on storage, is official requirements from their wiki https://wiki.termux.com/wiki/FAQ#What_are_system_requirements`
			`Personally I recommend also:`
			`* 1.5 GB in storage is minimum for good perfomance, do not continue, if you have small storage, because it cause "no enough space" error`
			`* arm64 proccessor and 64-bit OS, because on S1S13AF7 smartphone (Redmi 6A) have perfomance issues with 32 bit system, but maybe if install PostmarketOS on this smartphone it will be better because is more native Linux system than java wrapped Termux... Maybe also MIUI firmware issues`
			Anyway if you have low-end device, in step 1 when copying oneliner skip part with 'pkg update && pkg upgrade', but no any warranty, it can broke bot without upgrade Termux bootstrap packages. Also if your speed downloading updates very slow, press Ctrl+C, and try run `termux-change-repo` and select other region.

installing on termux instruction 2024-12-18 20:27:55 +02:00
			`0. Optional step: allow permission on storage in Termux before start, after this, step 3-4 can be skipped`
			`1. Run termux and enter this oneliner:`
			`pkg update && pkg upgrade && pkg install openssl python3 git termux-api && git clone https://code.criminallycute.fi/bioeb_org/ub4tg/ && cd ub4tg && pip3 install -r requirements.txt`
			`If pkg upgrade ask overwrite some files - press Y`
			`2. Now after this you can run bot:`
			`./run` or `python3 ubot.py`
			3. Termux will ask permission on storage, allow it. Restart Termux (enter `quit` or press CTRL+d)
			`4. Run bot again:`
			`cd ub4tg; ./run`
			`5. Follow first time setup, it creates config for you and asks some questions`
			`6. Enjoy`
time and date settings in termux installing instruction 2024-12-18 20:35:10 +02:00			`7. If you get some warnings about future events: sync your time in Android settings "date and time" and switch "network time" off/on`
installing on termux instruction 2024-12-18 20:27:55 +02:00
			`For start bot again (if Termux restarted) just enter:`
			`cd ub4tg; ./run`
			`For fast access to bot, make alias:`
			`echo "alias ub4tg='cd ~/ub4tg; ./run'" >> .bashrc`
			`then`
			`source ~/.bashrc`
			Now you can run bot in everywhere directory, just enter: `ub4tg`