2014-06-30 12:34:41 +02:00
telegram-bot
============
2014-12-21 12:44:31 +01:00
A Telegram Bot based on plugins using [tg ](https://github.com/vysheng/tg ).
2014-10-11 12:34:51 +02:00
2014-11-22 13:30:46 +01:00
Multimedia
----------
- When user sends image (png, jpg, jpeg) URL download and send it to origin.
- When user sends media (gif, mp4, pdf, etc.) URL download and send it to origin.
- When user sends twitter URL, send text and images to origin. Requieres OAuth Key.
- When user sends youtube URL, send to origin video image.
2014-11-23 11:55:02 +01:00
  
2014-08-06 01:19:31 +02:00
Command list
2014-10-11 16:27:05 +02:00
------------
2014-08-06 01:19:31 +02:00
```
2014-11-22 15:05:54 +01:00
!9gag -> send random image from 9gag
2014-11-22 13:30:46 +01:00
!echo [whatever] -> echoes the msg
!eur [USD] -> EURUSD market value
!uc3m -> Fortunes from Universidad Carlos III
!get (value_name) -> retrieves variables saved with !set
say hello to [name] -> Says hello to someone
!help -> Lists all available commands
!img [topic] -> search image with Google API and sends it
!ping -> bot sends pong
!rae [word] -> Spanish dictionary
!set [value_name] [data] -> Set value
2014-11-23 11:55:02 +01:00
!stats -> Numer of messages by user
2014-11-22 15:05:54 +01:00
!time [area] -> Displays the local time in an area
2014-11-22 13:30:46 +01:00
!tw [text] -> Sends a tweet
2014-11-22 15:05:54 +01:00
!version -> Shows bot version
2014-11-22 13:30:46 +01:00
!weather (city) -> weather in that city (Madrid is default)
2014-08-06 01:19:31 +02:00
```
2014-11-22 13:30:46 +01:00
2014-11-23 11:55:02 +01:00
Installation
------------
```bash
# Tested on Ubuntu 14.04, for other OSs check out https://github.com/vysheng/tg#installation
2014-12-10 12:19:50 +01:00
$ sudo apt-get install libreadline-dev libconfig-dev libssl-dev lua5.2 liblua5.2-dev libevent-dev unzip git
2014-11-23 11:55:02 +01:00
$ cd /tmp
$ wget http://luarocks.org/releases/luarocks-2.2.0.tar.gz
$ tar -xzvf luarocks-2.2.0.tar.gz
$ cd luarocks-2.2.0/
$ ./configure
$ make & & sudo make install
$ sudo luarocks install oauth
$ sudo luarocks install luasocket
```
```bash
# After those dependencies, lets install the bot
$ cd $HOME
2014-12-10 12:25:18 +01:00
$ git clone https://github.com/yagop/telegram-bot.git --recursive
2014-11-23 11:55:02 +01:00
$ cd telegram-bot/tg
$ ./configure & & make
2014-12-17 21:31:52 +01:00
$ cd ..
$ sed -i "s/yourusername/$(whoami)/g" etc/telegram.conf
$ sed -i "s_telegrambotpath_$(pwd)_g" etc/telegram.conf
$ sudo cp etc/telegram.conf /etc/init/
$ ./launch.sh # Will ask you for a phone number & confirmation code.
2014-12-10 12:19:50 +01:00
```
2014-12-21 12:44:31 +01:00
TODO
------------
- [ ] Enable / Disable plugins
- [ ] Cron
- [ ] Regex
- [ ] Moar plugins
Contact me
------------
You can contact me [via Telegram ](https://telegram.me/yago_perez ) but if you have an issue please [open ](https://github.com/yagop/telegram-bot/issues ) one.
