Updated description and added installation instructions, fixed a few typos and bugs.

This commit is contained in:
danogentili 2016-01-05 17:54:34 +01:00
parent 976a20a069
commit 641c55628d
4 changed files with 134 additions and 19 deletions

1
.gitignore vendored Normal file
View File

@ -0,0 +1 @@
*~

106
README.md
View File

@ -1,4 +1,108 @@
#bashbot #bashbot
A Telegram bot written in bash. A Telegram bot written in bash.
Uses [json.sh](https://github.com/dominictarr/JSON.sh). Uses [json.sh](https://github.com/dominictarr/JSON.sh) and tmux (for interactive chats).
## Instructions
### Create your first bot
1. Message @botfather https://telegram.me/botfather with the following
text: `/newbot`
If you don't know how to message by username, click the search
field on your Telegram app and type `@botfather`, you should be able
to initiate a conversation. Be careful not to send it to the wrong
contact, because some users has similar usernames to `botfather`.
![botfather initial conversation](http://i.imgur.com/aI26ixR.png)
2. @botfather replies with `Alright, a new bot. How are we going to
call it? Please choose a name for your bot.`
3. Type whatever name you want for your bot.
4. @botfather replies with `Good. Now let's choose a username for your
bot. It must end in `bot`. Like this, for example: TetrisBot or
tetris_bot.`
5. Type whatever username you want for your bot, minimum 5 characters,
and must end with `bot`. For example: `telesample_bot`
6. @botfather replies with:
Done! Congratulations on your new bot. You will find it at
telegram.me/telesample_bot. You can now add a description, about
section and profile picture for your bot, see /help for a list of
commands.
Use this token to access the HTTP API:
<b>123456789:AAG90e14-0f8-40183D-18491dDE</b>
For a description of the Bot API, see this page:
https://core.telegram.org/bots/api
7. Note down the 'token' mentioned above.
8. Type `/setprivacy` to @botfather.
![botfather later conversation](http://i.imgur.com/tWDVvh4.png)
9. @botfather replies with `Choose a bot to change group messages settings.`
10. Type `@telesample_bot` (change to the username you set at step 5
above, but start it with `@`)
11. @botfather replies with
'Enable' - your bot will only receive messages that either start
with the '/' symbol or mention the bot by username.
'Disable' - your bot will receive all messages that people send to groups.
Current status is: ENABLED
12. Type `Disable` to let your bot receive all messages sent to a
group. This step is up to you actually.
13. @botfather replies with `Success! The new status is: DISABLED. /help`
### Install bashbot
Clone the repository:
```
git clone https://github.com/topkecleon/telegram-bot-bash
```
Paste the token on line 12 (instead of tokenhere).
Then start editing the commands.
### Usage
To send messages use the ```send_message``` function:
```
send_message "$TARGET" "lol"
```
To send images use the ```send_photo``` function:
```
send_photo "$TARGET" "/home/user/doge.jpg"
```
To send custom keyboards use the ```send_keyboard``` function or the ```send_message``` function:
```
send_keyboard "$TARGET" "Text that will appear in chat?" "Yep" "No"
```
To create interactive chats, write (or edit the question script) a normal bash (or C or python) script, chmod +x it and then substitute ./question @ line 49 with 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:
```
echo "Text that will appear in chat? mykeyboardstartshere Yep No"
```
Same goes for images:
```
echo "Text that will appear in chat? myimagelocationstartshere /home/user/doge.jpg"
```
Or both:
```
echo "Text that will appear in chat? mykeyboardstartshere Yep No myimagelocationstartshere /home/user/doge.jpg"
```
That's it!
If you feel that there's something missing or if you found a bug, feel free to submit a pull request!

View File

@ -1,15 +1,18 @@
#!/bin/bash #!/bin/bash
# bashbot, the Telegram bot written in bash. # bashbot, the Telegram bot written in bash.
# Written by @topkecleon, Juan Potato (@awkward_potato), Lorenzo Santina (BigNerd95) and Daniil Gentili (danog) # Written by @topkecleon, Juan Potato (@awkward_potato), Lorenzo Santina (BigNerd95) and Daniil Gentili (danog)
# http://github.com/topkecleon/bashbot # https://github.com/topkecleon/telegram-bot-bash
# Depends on ./JSON.sh (http://github.com/dominictarr/./JSON.sh),
# which is MIT/Apache-licensed
# And on tmux (https://github.com/tmux/tmux),
# which is BSD-licensed
# Depends on JSON.sh (http://github.com/dominictarr/JSON.sh),
# which is MIT/Apache-licensed.
# This file is public domain in the USA and all free countries. # This file is public domain in the USA and all free countries.
# If you're in Europe, and public domain does not exist, then haha. # If you're in Europe, and public domain does not exist, then haha.
TOKEN='' TOKEN='tokenhere'
URL='https://api.telegram.org/bot'$TOKEN URL='https://api.telegram.org/bot'$TOKEN
MSG_URL=$URL'/sendMessage' MSG_URL=$URL'/sendMessage'
PHO_URL=$URL'/sendPhoto' PHO_URL=$URL'/sendPhoto'
@ -18,12 +21,19 @@ OFFSET=0
send_message() { send_message() {
local chat="$1" local chat="$1"
local text="$(echo "$2" | sed 's/ mykeyboardstartshere.*//g')" local text="$(echo "$2" | sed 's/ mykeyboardstartshere.*//g;s/ myimagelocationstartshere.*//g')"
local keyboard="$(echo "$2" | sed '/mykeyboardstartshere /!d;s/.*mykeyboardstartshere //g')" local keyboard="$(echo "$2" | sed '/mykeyboardstartshere /!d;s/.*mykeyboardstartshere //g;s/ myimagelocationstartshere.*//g')"
if [ "$keyboard" = "" ]; then local image="$(echo "$2" | sed '/myimagelocationstartshere /!d;s/.*myimagelocationstartshere //g;s/ mykeyboardstartshere.*//g;')"
res=$(curl -s "$MSG_URL" -F "chat_id=$chat" -F "text=$text") if [ "$keyboard" != "" ]; then
else
send_keyboard "$chat" "$text" "$keyboard" send_keyboard "$chat" "$text" "$keyboard"
local sent=y
fi
if [ "$image" != "" ]; then
send_photo "$chat" "$image"
local sent=y
fi
if [ "$sent" != "y" ];then
res=$(curl -s "$MSG_URL" -F "chat_id=$chat" -F "text=$text")
fi fi
} }
@ -31,9 +41,9 @@ send_keyboard() {
local chat="$1" local chat="$1"
local text="$2" local text="$2"
shift 2 shift 2
keyboard=init local keyboard=init
for f in $*;do keyboard="$keyboard, [\"$f\"]";done for f in $*;do local keyboard="$keyboard, [\"$f\"]";done
keyboard=${keyboard/init, /} local keyboard=${keyboard/init, /}
res=$(curl -s "$MSG_URL" --header "content-type: multipart/form-data" -F "chat_id=$chat" -F "text=$text" -F "reply_markup={\"keyboard\": [$keyboard],\"one_time_keyboard\": true}") res=$(curl -s "$MSG_URL" --header "content-type: multipart/form-data" -F "chat_id=$chat" -F "text=$text" -F "reply_markup={\"keyboard\": [$keyboard],\"one_time_keyboard\": true}")
} }
@ -46,7 +56,7 @@ startproc() {
local TARGET="$2" local TARGET="$2"
mkdir -p "$copname" mkdir -p "$copname"
mkfifo $copname/out mkfifo $copname/out
tmux new-session -d -n $copname "./question $TARGET 2>&1>$copname/out" tmux new-session -d -n $copname "./question 2>&1>$copname/out"
local pid=$(ps aux | sed '/tmux/!d;/'$copname'/!d;/sed/d;s/'$USER'\s*//g;s/\s.*//g') local pid=$(ps aux | sed '/tmux/!d;/'$copname'/!d;/sed/d;s/'$USER'\s*//g;s/\s.*//g')
echo $pid>$copname/pid echo $pid>$copname/pid
while ps aux | grep -v grep | grep -q $pid;do while ps aux | grep -v grep | grep -q $pid;do
@ -92,7 +102,7 @@ Available commands:
/cancel: Cancel any currently running interactive chats. /cancel: Cancel any currently running interactive chats.
Written by @topkecleon, Juan Potato (@awkward_potato), Lorenzo Santina (BigNerd95) and Daniil Gentili (danog) Written by @topkecleon, Juan Potato (@awkward_potato), Lorenzo Santina (BigNerd95) and Daniil Gentili (danog)
http://github.com/topkecleon/bashbot https://github.com/topkecleon/telegram-bot-bash
" "
;; ;;
*) *)
@ -114,9 +124,9 @@ while true; do {
res=$(curl -s $UPD_URL$OFFSET) res=$(curl -s $UPD_URL$OFFSET)
TARGET=$(echo $res | JSON.sh | egrep '\["result",0,"message","chat","id"\]' | cut -f 2) TARGET=$(echo $res | ./JSON.sh | egrep '\["result",0,"message","chat","id"\]' | cut -f 2)
OFFSET=$(echo $res | JSON.sh | egrep '\["result",0,"update_id"\]' | cut -f 2) OFFSET=$(echo $res | ./JSON.sh | egrep '\["result",0,"update_id"\]' | cut -f 2)
MESSAGE=$(echo $res | JSON.sh -s | egrep '\["result",0,"message","text"\]' | cut -f 2 | cut -d '"' -f 2) MESSAGE=$(echo $res | ./JSON.sh -s | egrep '\["result",0,"message","text"\]' | cut -f 2 | cut -d '"' -f 2)
OFFSET=$((OFFSET+1)) OFFSET=$((OFFSET+1))

View File

@ -9,7 +9,7 @@ until [ "$SUCCESS" = "y" ] ;do
read answer read answer
case $answer in case $answer in
'Yass!') echo "Goody!";SUCCESS=y;; 'Yass!') echo "Goody!";SUCCESS=y;;
'No') echo "Well that's weird";SUCCESS=y;; 'No') echo "Well that's weird.";SUCCESS=y;;
*) SUCCESS=n;; *) SUCCESS=n;;
esac esac
done done