leonjza / pytel

#NOTE: Before trying to use this for anything, have a look at Hogar first.

A pure python telegram-cli interface to send Telegram messages.

introduction

In short, PyTel interfaces with the telegram-cli allowing you to send telegram messages from python code as simple as telegram.send_message('Bob', 'Hello bob!')

installation

The most complex part of the installation is getting the actual telegram-cli client up and running. telegram-cli will always have to run and open a socket connection for PyTel to connect to.

• Follow the installation instructions for telegram-cli found here. We are assuming that you installed tg in /home/telegram for the purposes of this guide. This of course can be anywhere.
• Start telegram-cli. The syntax will depend on which socket type you want to use.
  • Unix Domain Sockets: /home/telegram/tg/bin/telegram-cli -k /home/telegram/tg/tg-server.pub -W -S /tmp/tg.sock
  • TCP socket on port 2361: /home/telegram/tg/bin/telegram-cli -k /home/telegram/tg/tg-server.pub -W -P 2361
• With the telegram-cli client ready, ensure that you provide the mobile number and password to login. This is the identity that will be used for messages.
• Install PyTel with pip install pytel
• Done!

example

Usage is really simple, check it out!

from pytel import tg

telegram = tg.Telegram('unix:///tmp/tg.sock') # For Unix Domain Socket
# telegram = tg.Telegram('tcp://127.0.0.1:4444') # For TCP socket

message = 'Dude! Whats mine say?'
telegram.send_message('Some Dude', message)

# We can also send an image! Of course, the image needs to be readable
# by the telegram-cli instance.
telegram.send_image('Some Dude', '/tmp/image.png')