mirror of
https://github.com/octoleo/telegram-bot-bash.git
synced 2024-11-22 15:35:09 +00:00
adjust bashbot and doc to changed dirs
This commit is contained in:
parent
a97cd69402
commit
3fb7796c99
11
README.md
11
README.md
@ -20,11 +20,10 @@ Bashbot [Documentation](https://github.com/topkecleon/telegram-bot-bash) and [Do
|
||||
1. Go to the directory you want to install bashbot, e.g.
|
||||
* your $HOME directory (install and run with your user-ID)
|
||||
* /usr/local if you want to run as service
|
||||
2. Clone the repository:
|
||||
```
|
||||
git clone --recursive https://github.com/topkecleon/telegram-bot-bash
|
||||
```
|
||||
3. Change to directory ```telegram-bot-bash```, run ```./bashbot.sh init``` and follow the instructions. At this stage you are asked for your Bots token given by botfather.
|
||||
2. [Download latest release archive from github](https://github.com/topkecleon/telegram-bot-bash/releases) and unpack it.
|
||||
|
||||
If you want the current version from github, clone the repository: ```git clone https://github.com/topkecleon/telegram-bot-bash```
|
||||
3. Change directory to ```telegram-bot-bash``` and run ```./bashbot.sh init```. Now follow the instructions. At one point you are asked for your Bots token given by botfather.
|
||||
|
||||
## Update bashbot
|
||||
1. [Download latest update zip from github](https://github.com/topkecleon/telegram-bot-bash/releases)
|
||||
@ -99,4 +98,4 @@ Bashbot is not more (in)secure as any other Bot written in any other language, w
|
||||
|
||||
If you feel that there's something missing or if you found a bug, feel free to submit a pull request!
|
||||
|
||||
#### $$VERSION$$ 0.70-dev-4-g12fd839
|
||||
#### $$VERSION$$ 0.70-dev-5-ga97cd69
|
||||
|
@ -10,7 +10,7 @@
|
||||
# This file is public domain in the USA and all free countries.
|
||||
# Elsewhere, consider it to be WTFPLv2. (wtfpl.net/txt/copying)
|
||||
#
|
||||
#### $$VERSION$$ 0.70-dev-4-g12fd839
|
||||
#### $$VERSION$$ 0.70-dev-5-ga97cd69
|
||||
#
|
||||
# Exit Codes:
|
||||
# - 0 sucess (hopefully)
|
||||
|
@ -61,5 +61,5 @@ group. This step is up to you actually.
|
||||
|
||||
#### [Next Getting started](2_usage.md)
|
||||
|
||||
#### $$VERSION$$ 0.70-dev-4-g12fd839
|
||||
#### $$VERSION$$ 0.70-dev-5-ga97cd69
|
||||
|
||||
|
@ -159,5 +159,5 @@ send_action "${CHAT[ID]}" "action"
|
||||
#### [Prev Create Bot](1_firstbot.md)
|
||||
#### [Next Advanced Usage](3_advanced.md)
|
||||
|
||||
#### $$VERSION$$ 0.70-dev-4-g12fd839
|
||||
#### $$VERSION$$ 0.70-dev-5-ga97cd69
|
||||
|
||||
|
@ -58,7 +58,7 @@ you have to use the function ```user_is_allowed``` to check if a user has the ca
|
||||
```
|
||||
|
||||
### Interactive Chats
|
||||
To create interactive chats, write (or edit the question script) a normal bash (or C or python) script, chmod +x it and then change the argument of the startproc function to match the command you usually use to start the script.
|
||||
To create interactive chats, write (or edit the exmaples/question.sh script) a normal bash (or C or python) script, chmod +x it and then change the argument of the startproc function to match the command you usually use to start the script.
|
||||
The text that the script will output will be sent in real time to the user, and all user input will be sent to the script (as long as it's running or until the user kills it with /cancel).
|
||||
To open up a keyboard in an interactive script, print out the keyboard layout in the following way:
|
||||
```bash
|
||||
@ -90,9 +90,9 @@ Note: Interactive Chats run independent from main bot and continue running until
|
||||
|
||||
### Background Jobs
|
||||
|
||||
A background job is similar to an interactive chat, but runs in the background and does only output massages instead of processing input from the user. In contrast to interactive chats it's possible to run multiple background jobs. To create a background job write a script or edit the notify script and use the funtion ```background``` to start it:
|
||||
A background job is similar to an interactive chat, but runs in the background and does only output massages instead of processing input from the user. In contrast to interactive chats it's possible to run multiple background jobs. To create a background job write a script or edit the examples/notify.sh script and use the funtion ```background``` to start it:
|
||||
```bash
|
||||
background "./notify" "jobname"
|
||||
background "examples/notify.sh" "jobname"
|
||||
```
|
||||
All output of the script will be sent to the user or chat. To stop a background job use:
|
||||
```bash
|
||||
@ -156,5 +156,5 @@ answer_inline_query "$iQUERY_ID" "cached_sticker" "identifier for the sticker"
|
||||
#### [Prev Advanced Usage](3_advanced.md)
|
||||
#### [Next Expert Use](4_expert.md)
|
||||
|
||||
#### $$VERSION$$ 0.70-dev-4-g12fd839
|
||||
#### $$VERSION$$ 0.70-dev-5-ga97cd69
|
||||
|
||||
|
@ -96,13 +96,13 @@ To change back the environment to your user-ID run ```sudo ./bashbot.sh init```
|
||||
To use bashbot as a system servive include a working ```bashbot.rc``` in your init system (systemd, /etc/init.d).
|
||||
|
||||
### Scedule bashbot from Cron
|
||||
An example crontab is provided in ```bashbot.cron```.
|
||||
An example crontab is provided in ```examples/bashbot.cron```.
|
||||
|
||||
- If you are running bashbot with your user-ID, copy the examples lines to your crontab and remove username ```nobody```.
|
||||
- if you run bashbot as an other user or a system service edit ```bashbot.cron``` to fit your needs and replace username```nobody``` with the username you want to run bashbot. copy the modified file to ```/etc/cron.d/bashbot```
|
||||
- if you run bashbot as an other user or a system service edit ```examples/bashbot.cron``` to fit your needs and replace username```nobody``` with the username you want to run bashbot. copy the modified file to ```/etc/cron.d/bashbot```
|
||||
|
||||
#### [Prev Expert Use](4_expert.md)
|
||||
#### [Next Best Practice](5_practice.md)
|
||||
|
||||
#### $$VERSION$$ 0.70-dev-4-g12fd839
|
||||
#### $$VERSION$$ 0.70-dev-5-ga97cd69
|
||||
|
||||
|
@ -89,9 +89,9 @@ Line 17:
|
||||
```
|
||||
As you can see my ```mybotcommands.inc.sh``` contains an useless echo command in 'TEXT=' assigment and can be replaced by ```TEXT="${TEXT}${WORD}"```
|
||||
```bash
|
||||
$ shellcheck -x notify
|
||||
$ shellcheck -x examples/notify
|
||||
OK
|
||||
$ shellcheck -x question
|
||||
$ shellcheck -x examples/question
|
||||
OK
|
||||
$ shellcheck -x commands.sh
|
||||
OK
|
||||
@ -112,5 +112,5 @@ The second warning is about an unused variable, this is true because in our exam
|
||||
#### [Prev Best Practice](5_practice.md)
|
||||
#### [Next Functions Reference](6_reference.md)
|
||||
|
||||
#### $$VERSION$$ 0.70-dev-4-g12fd839
|
||||
#### $$VERSION$$ 0.70-dev-5-ga97cd69
|
||||
|
||||
|
@ -216,11 +216,11 @@ fi
|
||||
##### startproc
|
||||
```startproc``` starts a script (or C or python program etc.) running in parallel to your Bot. The text that the script outputs is sent to the user or chat, user input will be sent back to the script. see [Advanced Usage](3_advanced.md#Interactive-Chats)
|
||||
|
||||
*usage:* startproc "./script"
|
||||
*usage:* startproc "script"
|
||||
|
||||
*example:*
|
||||
```bash
|
||||
startproc './calc'
|
||||
startproc 'examples/calc.sh'
|
||||
```
|
||||
|
||||
##### checkproc
|
||||
@ -232,7 +232,7 @@ Return true (0) if an interactive script active in the given chat.
|
||||
```bash
|
||||
checkproc
|
||||
if [ "$res" -gt 0 ] ; then
|
||||
startproc "./calc"
|
||||
startproc "examples/calc.sh"
|
||||
else
|
||||
send_normal_message "${CHAT[ID]}" "Calc already running ..."
|
||||
fi
|
||||
@ -258,11 +258,11 @@ fi
|
||||
|
||||
In contrast to interactive chats, background jobs do not recieve user input and can run forever. In addition you can suspend and restart running jobs, e.g. after reboot.
|
||||
|
||||
*usage:* background "./script" "jobname"
|
||||
*usage:* background "script" "jobname"
|
||||
|
||||
*example:*
|
||||
```bash
|
||||
background "./notify" "notify"
|
||||
background "examples/notify.sh" "notify"
|
||||
```
|
||||
|
||||
##### checkback
|
||||
@ -275,7 +275,7 @@ Return true (0) if an background job is active in the given chat.
|
||||
checkback "notify"
|
||||
if [ "$res" -gt 0 ] ; then
|
||||
send_normal_message "${CHAT[ID]}" "Start notify"
|
||||
background "./notify" "notify"
|
||||
background "examples/notify.sh" "notify"
|
||||
else
|
||||
send_normal_message "${CHAT[ID]}" "Process notify already running."
|
||||
fi
|
||||
@ -347,5 +347,5 @@ Send Input from Telegram to waiting Interactive Chat.
|
||||
|
||||
#### [Prev Best Practice](5_practice.md)
|
||||
|
||||
#### $$VERSION$$ 0.70-dev-4-g12fd839
|
||||
#### $$VERSION$$ 0.70-dev-5-ga97cd69
|
||||
|
||||
|
Loading…
Reference in New Issue
Block a user