telegram-bot ============ [![](https://travis-ci.org/yagop/telegram-bot.svg?branch=master)](https://travis-ci.org/yagop/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.lua 9GAG for telegram !9gag: Send random image from 9gag
boobs.lua Gets a random boobs or butts pic !boobs: Get a boobs NSFW image. :underage:
!butts: Get a butts NSFW image. :underage:
btc.lua Bitcoin global average market value (in EUR or USD) !btc [EUR|USD] [amount]
bugzilla.lua Lookup bugzilla status update /bot bugzilla [bug number]
echo.lua Simplest plugin ever! !echo [whatever]: echoes the msg
eur.lua EURUSD market value !eur [USD]
fortunes_uc3m.lua Fortunes from Universidad Carlos III !uc3m
get.lua Retrieves variables saved with !set !get (value_name): Returns the value_name value.
giphy.lua GIFs 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.lua Searches Google and send results !google [terms]: Searches Google and send results
gps.lua generates a map showing the given GPS coordinates !gps latitude,longitude: generates a map showing the given GPS coordinates
hackernews.lua Show top 5 hacker news (ycombinator.com) !hackernews
hello.lua Says hello to someone say hello to [name]
help.lua Help plugin. Get info from other plugins. !help: Show list of plugins.
!help all: Show all commands for every plugin.
!help [plugin name]: Commands for that plugin.
images.lua When user sends image URL (ends with png, jpg, jpeg) download and send it to origin.
imdb.lua Imdb plugin for telegram !imdb [movie]
img_google.lua Search image with Google API and sends it. !img [term]: Random search an image with Google API.
invite.lua Invite other user to the chat group !invite name [user_name]
!invite id [user_id]
location.lua Gets information about a location, maplink and overview !loc (location): Gets information about a location, maplink and overview
magic8ball.lua Magic 8Ball !magic8ball
media.lua When user sends media URL (ends with gif, mp4, pdf, etc.) download and send it to origin.
ping.lua If domain is offline, send msg to peer
plugins.lua Plugin to manage other plugins. Enable, disable or reload. !plugins: list all plugins
!plugins enable [plugin]: enable plugin
!plugins disable [plugin]: disable plugin
!plugins reeload: reloads all plugins
quotes.lua Quote plugin, you can create and retrieves random quotes !addquote [msg]
!quote
rae.lua Spanish dictionary !rae [word]: Search that word in Spanish dictionary.
set.lua Plugin for saving values. get.lua plugin is necesary to retrieve them. !set [value_name] [data]: Saves the data with the value_name name.
stats.lua Plugin to update user stats. !stats: Returns a list of Username [telegram_id]: msg_num
time.lua Displays the local time in an area !time [area]: Displays the local time in that area
translate.lua Translate some text !translate text. Translate to english the text.
!translate target_lang text.
!translate source,target text
twitter.lua When user sends twitter URL, send text and images to origin. Requieres OAuth Key.
twitter_send.lua Sends a tweet !tw [text]: Sends the Tweet with the configured accout.
version.lua Shows bot version !version: Shows bot version
vote.lua Plugin for voting in groups. !voting reset: Reset all the votes.
!vote [number]: Cast the vote.
!voting stats: Shows the statistics of voting.
weather.lua weather in that city (Madrid is default) !weather (city)
xkcd.lua Send comic images from xkcd !xkcd (id): Send an xkcd image and title. If not id, send a random one
youtube.lua Sends YouTube info and 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 make unzip git ``` ```bash # After those dependencies, lets install the bot cd $HOME git clone https://github.com/yagop/telegram-bot.git cd telegram-bot ./launch.sh install ./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 enabled 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.