Skip to content

Iran-Python/pybotgram

 
 

Repository files navigation

pybotgram

A Telegram Bot written in Python with plugins based in yagop telegram-bot using tg

State

Currently the bot is in development, feel free to contribute, it would be really appreciated!

Plugins

Name Description Usage
calc.py A calculator to evaluate expressions !calc (expression)
channels.py Plugin to manage channels.
Enable or disable channel.
!channel enable: enable current channel
!channel disable: disable current channel
clever.py Cleverbot plugin. !clever (text): Say the text to cleverbot and receive the answer
download_media.py When bot receives a media msg, download the media to the file system. This plugin is automatic when someone send a file.
echo.py Simplest plugin ever! !echo (text)
help.py 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.
imgtosticker.py Convert a photo to sticker! !imgtosticker start: Next photo you send, as image or document, it will try to convert to sticker and send you.
!imgtosticker stop: Stop the service, won't convert the next image.
If you are in "start" mode, send a photo as document or image, and get the sticker!
media.py When user sends media URL (ends with gif, mp4, pdf, etc.) download and send it to origin. This plugin is automatic when you send an URL.
money.py Currency converter !money (from currency) (amount) (to currency)
plugins.py Plugin to manage other plugins
Enable, disable or reload.
!plugins: list all plugins.
!plugins enable [plugin]: enable plugin.
!plugins disable [plugin]: disable plugin.
!plugins disable [plugin] chat: disable plugin only this chat.
!plugins reload: reloads all plugins.

Installation

In order to install it, you need some system dependencies.

  • tg dependencies:
# 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 libjansson-dev libpython-dev make
  • bot dependencies:
sudo apt-get install git python3 libpython3-dev python-pip python3-pip
sudo pip3 install virtualenv
  • Optional dependencies: If you want to have all the plugins, you will have to install some more dependencies:
sudo apt-get install libtiff4-dev libjpeg8-dev zlib1g-dev libfreetype6-dev liblcms1-dev libwebp-dev

To install in other OS, see this are the libraries that need extra dependencies:

Plugins that you'll can't use if you don't install this optional dependencies:

  • imgtosticker: Use PIL (pillow)

Once you have all dependencies, and the optional if you want, install the bot and run it:

  • bot:
cd $HOME
git clone https://github.com/rockneurotiko/pybotgram/
cd pybotgram
./launch.sh install
./launch.sh # Will ask you for a phone number & confirmation code
# (The number is like +cc00000000 where cc is the country code)

Enable more 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.json (generated by the bot), stop de bot and edit if necessary.

The privileged users are identified with his telegram ID, and you can write all you want in data/config.json, in the list sudo_users, like this:

"sudo_users": [00000000, 11111111, 22222222, 33333333]

Contact me

You can contact me via Telegram but if you have an issue please open one.

About

A Telegram Bot writed in Python with plugins based in yagop's telegram-bot

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 93.9%
  • Shell 6.1%