telegram-bot-bash/examples/README.md

#### [Home](../README.md)

## Bashbot examples

### bashbot multi
An example wrapper to run multiple instances of bashbot, use ```./bashbot-multi.sh botname command```

### bashbot.cron
An example crontab is provided in ```examples/bashbot.cron```, see [Expert use](../doc/4_expert.md#Scedule-bashbot-from-Cron)


### Interactive chats
Two examples for interactive scripts are provided as **calc.sh** and **question.sh**, see [Advanced use](../doc/3_advanced.md#Interactive-Chats)

### Background scripts

Background jobs are an easy way to provide sceduled messages or alerts if something happens.
**notify.sh** is a simple example on how to send a message every x seonds, e.g. current time.

**background-scripts** contains a more useful example on how to start and stop different scripts plus some example backgound scripts.

```
    mycommands.sh - /run_xxx and /kill-xxx wil start any script named run_xxx.sh

    run_diskusage.sh - shows disk usage every 100 seconds
    run_filename.sh	- shown the name of new files in a named dir
    run_filecontent.sh	- shown the content of new files in a named dir
    run_notify.sh - same as notify.sh
```
**Note:** Output of system commands often contains newlines, each newline results in a telegram message, the function 'send_telegram' in
mycommands.sh avoids this by converting each newline to ' mynewlinestartshere ' before output the string.

### System Status

**send-system-status** contains an example for commands showing status of different subsystems. This example is adapted from
 https://github.com/RG72/telegram-bot-bash to current bashbot commands, but not fully tested. This will show how easy you can
convert existing bots.

```
    mycommands.sh - commands to show system status
    botacl - controls who can show system status

*Availiable commands*:
	/se *sensors*
	/smb *smbstatus*
	/free *memory status*
	/md *raid status*
	/lvm *lvm status*
	/lvsd *Datailed lvm status*
	/df *disk space*
	/ifconfig *ifconfig output*
	/smart *sda* _smart status for sda drive_
```
### External scripts

**external-use** will contain some examples on how to send messages from external scripts to Telegram chats or users.

#### $$VERSION$$ v0.90-rc1-0-g93b4914