2015-04-05 23:20:07 +02:00
telegram-bot
2014-06-30 12:34:41 +02:00
============
2015-04-05 23:20:07 +02:00
[](https://travis-ci.org/yagop/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.
2015-01-04 19:51:32 +01:00
- When user sends twitter URL, send text and images to origin. Requires OAuth Key.
2014-11-22 13:30:46 +01:00
- When user sends youtube URL, send to origin video image.
2014-11-23 11:55:02 +01:00
  
2015-01-12 21:17:16 +01:00
2015-01-24 17:16:35 +01:00
Bot Commands
2014-10-11 16:27:05 +02:00
------------
2015-01-24 17:16:35 +01:00
< table >
2015-04-05 16:18:00 +02:00
< thead >
< tr >
< td >
< strong >
Name
< / strong >
< / td >
< td >
< strong >
Description
< / strong >
< / td >
< td >
< strong >
Usage
< / strong >
< / td >
< / tr >
< / thead >
< tbody >
< tr >
< td >
9gag.lua
< / td >
< td >
9GAG for telegram
< / td >
< td >
!9gag: Send random image from 9gag
< / td >
< / tr >
< tr >
< td >
boobs.lua
< / td >
< td >
Gets a random boobs or butts pic
< / td >
< td >
!boobs: Get a boobs NSFW image. :underage:
< br >
!butts: Get a butts NSFW image. :underage:
< br >
< / td >
< / tr >
< tr >
< td >
btc.lua
< / td >
< td >
Bitcoin global average market value (in EUR or USD)
< / td >
< td >
!btc [EUR|USD] [amount]
< / td >
< / tr >
< tr >
< td >
bugzilla.lua
< / td >
< td >
Lookup bugzilla status update
< / td >
< td >
/bot bugzilla [bug number]
< / td >
< / tr >
< tr >
< td >
echo.lua
< / td >
< td >
Simplest plugin ever!
< / td >
< td >
!echo [whatever]: echoes the msg
< / td >
< / tr >
< tr >
< td >
eur.lua
< / td >
< td >
EURUSD market value
< / td >
< td >
!eur [USD]
< / td >
< / tr >
< tr >
< td >
fortunes_uc3m.lua
< / td >
< td >
Fortunes from Universidad Carlos III
< / td >
< td >
!uc3m
< / td >
< / tr >
< tr >
< td >
get.lua
< / td >
< td >
Retrieves variables saved with !set
< / td >
< td >
!get (value_name): Returns the value_name value.
< / td >
< / tr >
< tr >
< td >
giphy.lua
< / td >
< td >
GIFs from telegram with Giphy API
< / td >
< td >
!gif (term): Search and sends GIF from Giphy. If no param, sends a trending GIF.
< br >
!giphy (term): Search and sends GIF from Giphy. If no param, sends a trending GIF.
< br >
< / td >
< / tr >
< tr >
< td >
google.lua
< / td >
< td >
Searches Google and send results
< / td >
< td >
!google [terms]: Searches Google and send results
< / td >
< / tr >
< tr >
< td >
gps.lua
< / td >
< td >
generates a map showing the given GPS coordinates
< / td >
< td >
!gps latitude,longitude: generates a map showing the given GPS coordinates
< / td >
< / tr >
< tr >
< td >
hackernews.lua
< / td >
< td >
Show top 5 hacker news (ycombinator.com)
< / td >
< td >
!hackernews
< / td >
< / tr >
< tr >
< td >
hello.lua
< / td >
< td >
Says hello to someone
< / td >
< td >
say hello to [name]
< / td >
< / tr >
< tr >
< td >
help.lua
< / td >
< td >
Help plugin. Get info from other plugins.
< / td >
< td >
!help: Show list of plugins.
< br >
!help all: Show all commands for every plugin.
< br >
!help [plugin name]: Commands for that plugin.
< br >
< / td >
< / tr >
< tr >
< td >
images.lua
< / td >
< td >
When user sends image URL (ends with png, jpg, jpeg) download and send it to origin.
< / td >
< td >
< / td >
< / tr >
< tr >
< td >
imdb.lua
< / td >
< td >
Imdb plugin for telegram
< / td >
< td >
!imdb [movie]
< / td >
< / tr >
< tr >
< td >
img_google.lua
< / td >
< td >
Search image with Google API and sends it.
< / td >
< td >
!img [term]: Random search an image with Google API.
< / td >
< / tr >
< tr >
< td >
invite.lua
< / td >
< td >
Invite other user to the chat group
< / td >
< td >
!invite name [user_name]
< br >
!invite id [user_id]
< br >
< / td >
< / tr >
< tr >
< td >
location.lua
< / td >
< td >
Gets information about a location, maplink and overview
< / td >
< td >
!loc (location): Gets information about a location, maplink and overview
< / td >
< / tr >
< tr >
< td >
magic8ball.lua
< / td >
< td >
Magic 8Ball
< / td >
< td >
!magic8ball
< / td >
< / tr >
< tr >
< td >
media.lua
< / td >
< td >
When user sends media URL (ends with gif, mp4, pdf, etc.) download and send it to origin.
< / td >
< td >
< / td >
< / tr >
< tr >
< td >
ping.lua
< / td >
< td >
If domain is offline, send msg to peer
< / td >
< td >
< / td >
< / tr >
< tr >
< td >
plugins.lua
< / td >
< td >
Plugin to manage other plugins. Enable, disable or reload.
< / td >
< td >
!plugins: list all plugins
< br >
!plugins enable [plugin]: enable plugin
< br >
!plugins disable [plugin]: disable plugin
< br >
!plugins reeload: reloads all plugins
< br >
< / td >
< / tr >
< tr >
< td >
quotes.lua
< / td >
< td >
Quote plugin, you can create and retrieves random quotes
< / td >
< td >
!addquote [msg]
< br >
!quote
< br >
< / td >
< / tr >
< tr >
< td >
rae.lua
< / td >
< td >
Spanish dictionary
< / td >
< td >
!rae [word]: Search that word in Spanish dictionary.
< / td >
< / tr >
< tr >
< td >
set.lua
< / td >
< td >
Plugin for saving values. get.lua plugin is necesary to retrieve them.
< / td >
< td >
!set [value_name] [data]: Saves the data with the value_name name.
< / td >
< / tr >
< tr >
< td >
stats.lua
< / td >
< td >
Plugin to update user stats.
< / td >
< td >
!stats: Returns a list of Username [telegram_id]: msg_num
< / td >
< / tr >
< tr >
< td >
time.lua
< / td >
< td >
Displays the local time in an area
< / td >
< td >
!time [area]: Displays the local time in that area
< / td >
< / tr >
< tr >
< td >
translate.lua
< / td >
< td >
Translate some text
< / td >
< td >
!translate text. Translate to english the text.
< br >
!translate target_lang text.
< br >
!translate source,target text
< br >
< / td >
< / tr >
< tr >
< td >
twitter.lua
< / td >
< td >
When user sends twitter URL, send text and images to origin. Requieres OAuth Key.
< / td >
< td >
< / td >
< / tr >
< tr >
< td >
twitter_send.lua
< / td >
< td >
Sends a tweet
< / td >
< td >
!tw [text]: Sends the Tweet with the configured accout.
< / td >
< / tr >
< tr >
< td >
version.lua
< / td >
< td >
Shows bot version
< / td >
< td >
!version: Shows bot version
< / td >
< / tr >
< tr >
< td >
vote.lua
< / td >
< td >
Plugin for voting in groups.
< / td >
< td >
!voting reset: Reset all the votes.
< br >
!vote [number]: Cast the vote.
< br >
!voting stats: Shows the statistics of voting.
< br >
< / td >
< / tr >
< tr >
< td >
weather.lua
< / td >
< td >
weather in that city (Madrid is default)
< / td >
< td >
!weather (city)
< / td >
< / tr >
< tr >
< td >
xkcd.lua
< / td >
< td >
Send comic images from xkcd
< / td >
< td >
!xkcd (id): Send an xkcd image and title. If not id, send a random one
< br >
< / td >
< / tr >
< tr >
< td >
youtube.lua
< / td >
< td >
Sends YouTube info and image.
< / td >
< td >
< / td >
< / tr >
< / tbody >
2015-02-19 21:54:55 +01:00
< / table >
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
2015-04-05 22:13:50 +02:00
sudo apt-get install libreadline-dev libconfig-dev libssl-dev lua5.2 liblua5.2-dev libevent-dev make unzip git
2014-11-23 11:55:02 +01:00
```
2015-04-05 22:13:50 +02:00
2014-11-23 11:55:02 +01:00
```bash
# After those dependencies, lets install the bot
2015-04-05 22:13:50 +02:00
cd $HOME
2015-04-05 23:36:11 +02:00
git clone https://github.com/yagop/telegram-bot.git
cd telegram-bot
2015-04-05 22:13:50 +02:00
./launch.sh install
./launch.sh # Will ask you for a phone number & confirmation code.
2015-01-12 21:17:16 +01:00
```
Enable more [`plugins` ](https://github.com/yagop/telegram-bot/tree/master/plugins )
-------------
See the plugins list with `!plugins` command.
2015-01-12 21:26:24 +01:00
Enable a disabled plugin by `!plugins enable [name]` .
2015-01-12 21:17:16 +01:00
2015-02-02 18:59:26 +01:00
Disable an enabled plugin by `!plugins disable [name]` .
2015-01-12 21:17:16 +01:00
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
2014-12-17 21:31:52 +01:00
$ 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/
2015-01-14 15:52:30 +01:00
$ sudo start telegram # To start it
$ sudo stop telegram # To stop it
2014-12-10 12:19:50 +01:00
```
2014-12-21 12:44:31 +01:00
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.
