Skip to main content

Full-featured Telegram client library for Python 3

Project description

⭐️ Thanks everyone who has starred the project, it means a lot!

logo Telethon is an asyncio Python 3 library to interact with Telegram’s API.

If you’re upgrading from Telethon pre-1.0 to 1.0, please make sure to read this section of the documentation, or pip install telethon-sync which is compatible with synchronous code. Don’t forget to remove the asynchronous version (pip uninstall telethon) if you do install sync.

What is this?

Telegram is a popular messaging application. This library is meant to make it easy for you to write Python programs that can interact with Telegram. Think of it as a wrapper that has already done the heavy job for you, so you can focus on developing an application.

Installing

pip3 install telethon

Creating a client

from telethon import TelegramClient, sync

# These example values won't work. You must get your own api_id and
# api_hash from https://my.telegram.org, under API Development.
api_id = 12345
api_hash = '0123456789abcdef0123456789abcdef'

client = TelegramClient('session_name', api_id, api_hash)
client.start()

Doing stuff

print(client.get_me().stringify())

client.send_message('username', 'Hello! Talking to you from Telethon')
client.send_file('username', '/home/myself/Pictures/holidays.jpg')

client.download_profile_photo('me')
messages = client.get_messages('username')
messages[0].download_media()

Next steps

Do you like how Telethon looks? Check out Read The Docs for a more in-depth explanation, with examples, troubleshooting issues, and more useful information.

Project details


Release history Release notifications | RSS feed

This version

1.2

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Telethon-1.2.tar.gz (1.1 MB view details)

Uploaded Source

Built Distribution

Telethon-1.2-py3-none-any.whl (346.6 kB view details)

Uploaded Python 3

File details

Details for the file Telethon-1.2.tar.gz.

File metadata

  • Download URL: Telethon-1.2.tar.gz
  • Upload date:
  • Size: 1.1 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/39.2.0 requests-toolbelt/0.8.0 tqdm/4.23.4 CPython/3.7.0

File hashes

Hashes for Telethon-1.2.tar.gz
Algorithm Hash digest
SHA256 be1adad947b0d4395fbc156e24326efda61e94dc5541b14d2a7c3f1a81e5dddd
MD5 19ea4e80371e10bee0583a2c491c9491
BLAKE2b-256 f4b298c2b4f9eb8026109a6ffeb1e5e7c2b8e40260dee639ab02e5b0df1bd337

See more details on using hashes here.

File details

Details for the file Telethon-1.2-py3-none-any.whl.

File metadata

  • Download URL: Telethon-1.2-py3-none-any.whl
  • Upload date:
  • Size: 346.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/39.2.0 requests-toolbelt/0.8.0 tqdm/4.23.4 CPython/3.7.0

File hashes

Hashes for Telethon-1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 f3b08793260960724945db69f6869477f315acb8595c1a2a552364f3808b7819
MD5 50694819e8f66d3e85849328c4aa5919
BLAKE2b-256 0ad6cbc8775cf1c4d29fdeadbb0dc73616ab62aef70a3f702120ec916f686fe8

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page