telegram-bot ============ A Telegram Bot based on plugins using [tg](https://github.com/vysheng/tg). 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. Requires OAuth Key. - When user sends youtube URL, send to origin video image. ![http://i.imgur.com/0FGUvU0.png](http://i.imgur.com/0FGUvU0.png) ![http://i.imgur.com/zW7WWWt.png](http://i.imgur.com/zW7WWWt.png) ![http://i.imgur.com/zW7WWWt.png](http://i.imgur.com/kPK7paz.png) Bot Commands ------------
Name Description Usage
9gag.lua9GAG for telegram!9gag: Send random image from 9gag
btc.luaBitcoin global average market value (in EUR or USD)!btc [EUR|USD] [amount]
echo.luaechoes the msg!echo [whatever]
eur.luaEURUSD market value!eur [USD]
fortunes_uc3m.luaFortunes from Universidad Carlos III!uc3m
get.luaretrieves variables saved with !set!get (value_name)
giphy.luaGIFs from telegram with Giphy API!gif (term): Search and sends GIF from Giphy. If no param, sends a trending GIF.
!giphy (term): Search and sends GIF from Giphy. If no param, sends a trending GIF.
google.luaSearches Google and send results!google [terms]
gps.luagenerates a map showing the given GPS coordinates!gps latitude,longitude
hello.luaSays hello to someonesay hello to [name]
help.luaLists all available commands!help
!help md
images.luaWhen user sends image URL (ends with png, jpg, jpeg) download and send it to origin.
img_google.luasearch image with Google API and sends it!img [topic]
invite.luaInvite other user to the chat group!invite name [user_name]
!invite id [user_id]
location.luaGets information about a location, maplink and overview!loc (location)
media.luaWhen user sends media URL (ends with gif, mp4, pdf, etc.) download and send it to origin.
ping.luaIf domain is offline, send msg to peer
plugins.luaEnables, disables and reloads plugins. Privileged users only.!plugins: list all plugins
!plugins enable [plugin]
!plugins disable [plugin]
!plugins reload
rae.luaSpanish dictionary!rae [word]
set.luaSet value!set [value_name] [data]
stats.luaNumer of messages by user!stats
time.luaDisplays the local time in an area!time [area]
twitter.luaWhen user sends twitter URL, send text and images to origin. Requieres OAuth Key.
twitter_send.luaSends a tweet!tw [text]
version.luaShows bot version!version
weather.luaweather in that city (Madrid is default)!weather (city)
youtube.luasends YouTube image
Installation ------------ ```bash # Tested on Ubuntu 14.04, for other OSs check out https://github.com/vysheng/tg#installation $ sudo apt-get install libreadline-dev libconfig-dev libssl-dev lua5.2 liblua5.2-dev libevent-dev unzip git $ 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 $ git clone https://github.com/yagop/telegram-bot.git --recursive $ cd telegram-bot/tg $ ./configure && make && cd .. $ ./launch.sh # Will ask you for a phone number & confirmation code. ``` Enable more [`plugins`](https://github.com/yagop/telegram-bot/tree/master/plugins) ------------- See the plugins list with `!plugins` command. Enable a disabled plugin by `!plugins enable [name]`. Disable an eanbled plugin by `!plugins disable [name]`. Those commands require a privileged user, privileged users are defined inside `data/config.lua` (generated by the bot), stop de bot and edit if necessary. Run it as a daemon ------------ If your linux/unix comes with [upstart](http://upstart.ubuntu.com/) you can run the bot by this way ```bash $ 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/ $ sudo start telegram # To start it $ sudo stop telegram # To stop it ``` 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.