Expert use: Run as system service or from cron

This commit is contained in:
Kay Marquardt (Gnadelwartz) 2019-03-25 15:12:13 +01:00
parent 51df0a9b92
commit a4374e1d33

View File

@ -83,18 +83,18 @@ group. This step is up to you actually.
```
git clone --recursive https://github.com/topkecleon/telegram-bot-bash
```
3. Change to directory ```telegram-bot.bash``` and run ```./bashbot.sh init``` and follow the instructions.
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.
Then start editing the ```commands.sh``` file.
## Programming your own Bot
All Commands for the Bot are at the end the ```commands.sh``` file. Here you ifind some exmples how to process messages and send out text.
All Commands for the Bot are at the end the ```commands.sh``` file. Here you find some examples how to process messages and send out text.
The default commands like /info, /start, /help /cancel should't changed.
### Receive data
Evertime a Message is recived, you can read incoming data using the following variables:
Evertime a Message is recieved, you can read incoming data using the following variables:
* ```$MESSAGE```: Incoming messages
* ```${MESSAGE[ID]}```: ID of incoming message
@ -143,7 +143,7 @@ Evertime a Message is recived, you can read incoming data using the following va
### Usage of bashbot functions
#### Send_messages
#### send_message
To send messages use the ```send_message``` function:
```
send_message "${CHAT[ID]}" "lol"
@ -163,7 +163,8 @@ To forward messages use the ```forward``` function:
```
forward "${CHAT[ID]}" "from_chat_id" "message_id"
```
*For safety and performance reasoms I recommend to use send_xxxx_message direct and not the universal send_message function.*
#### For safety and performance reasoms I recommend to use send_xxxx_message direct and not the universal send_message function.*
To send regular text without any markdown use:
```
send_text_message "${CHAT[ID]}" "lol"
@ -174,10 +175,17 @@ send_markdown_message "${CHAT[ID]}" "lol *bold*"
```
To send text with html:
```
send_html_message "${CHAT[ID]}" "lol <b>bold</b>
send_html_message "${CHAT[ID]}" "lol <b>bold</b>"
```
#### Send files etc.
If your Bot is Admin in a Chat you can delete every message, if not you can delete only messages.
To delete a message with a known ${MESSAGE[ID]} you can simple use:
```
delete_message "${CHAT[ID]}" "${MESSAGE[ID]}"
```
#### Send files, location etc.
To send images, videos, voice files, photos ecc use the ```send_photo``` function (remember to change the safety Regex @ line 14 of command.sh to allow sending files only from certain directories):
```
send_file "${CHAT[ID]}" "/home/user/doge.jpg" "Lool"
@ -307,9 +315,16 @@ To use the functions provided in this script in other scripts simply source bash
## Managing your Bot
####Note: running bashbot as root is highly danger and not recommended. See Expert useage below.
### Start / Stop
Start or Stop your Bot use the following commands:
```
bash bashbot.sh start
```
```
bash bashbot.sh kill
```
### User count
To count the total number of users that ever used the bot run the following command:
@ -370,6 +385,37 @@ E.g. the Emoticons ``` 😁 😘 ❤️ 😊 👍 ``` are encoded as:
'\uXXXX' and '\UXXXXXXXX' escaped endocings are supported by zsh, bash, ksh93, mksh and FreeBSD sh, GNU 'printf' and GNU 'echo -e', see [this Stackexchange Answer](https://unix.stackexchange.com/questions/252286/how-to-convert-an-emoticon-specified-by-a-uxxxxx-code-to-utf-8/252295#252295) for more information.
## Expert Usage
Bashbot is desingned to run manually by the user who installed it. Nevertheless it's possible to run it e.g. by an other user-ID, as a system service or sceduled from cron. This is onyl recommended for an experiend linux user.
### Run as other user or system service
Running bashbot as an other user is only possible (and strongly recommended) for root.
Edit the example rc file ```bashbot.rc``` and set the value ```runas``` to the user you want to run bashbot. Uncomment the ```runcmd``` availible on your system and fill the name of your Bot in ```name```. Now you can start ans stop your bot by bashbot.rc
To start your bot use:
```
./bashbot.rc start
```
Now type ```ps -ef | grep bashbot``` to verify your Bot is running as the desired user.
If you use bashbot.rc to start your Bot as an other user your must use bashbot.rc to manage your Bot! The following commands are availible:
```
./bashbot.rc start
./bashbot.rc stop
./bashbot.rc status
./bashbot.rc suspendback
./bashbot.rc resumeback
./bashbot.rc killback
``
To use bashbot as a system servive include your working ```bashbot.rc``` in your init system (systemd, /etc/init.d).
### Scedule bashbot from Cron
An example crontab is provided in ```bashbot.cron```.
- If you are running bashbot with your local user-ID, copy the examples to your crontab and remove username ```www```.
- if you run crontab as an other user or a system service edit ```bashbot.cron``` to fit your needs and replace username````www``` with the username you want to run bashbot. copy the modified file to /etc/cron.d
## That's it!
If you feel that there's something missing or if you found a bug, feel free to submit a pull request!