telegram-bot-bash/examples/README.md
Kay Marquardt (Gnadelwartz) 8a119f8806 some small fixes, start dev3
2020-05-14 13:04:57 +02:00

2.2 KiB

Home

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

Interactive chats

Two examples for interactive scripts are provided as calc.sh and question.sh, see Advanced use

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.94-dev3-0-geef955a