Skip to main content

Full-featured Telegram client library for Python 3

Project description

Telethon

Telethon is an asyncio Python 3 MTProto library to interact with Telegram's API as a user or through a bot account (bot API alternative).

Important

If you have code using Telethon before its 1.0 version, you must read Compatibility and Convenience to learn how to migrate. As with any third-party library for Telegram, be careful not to break Telegram's ToS or Telegram can ban the account

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.

What telethon-up does:3

⭐️The purpose of telethon-up is that it automatically updates the TL layer (api.tl) to the latest version of Telegram⭐️:3

Installing

pip3 install telethon-up

Creating a client

import telethon_up
from telethon import TelegramClient, events, sync
#import telethon
#print(f"Layer Start: {telethon.tl.alltlobjects.LAYER}")
telethon_up.check()
#print(f"Layer After: {telethon.tl.alltlobjects.LAYER}")
# Automatically update the Telethon API layer (api.tl).
# 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()

@client.on(events.NewMessage(pattern='(?i)hi|hello'))
async def handler(event):
  await event.respond('Hey!')

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


Download files

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

Source Distribution

telethon_up-1.3.tar.gz (4.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

telethon_up-1.3-py3-none-any.whl (4.5 kB view details)

Uploaded Python 3

File details

Details for the file telethon_up-1.3.tar.gz.

File metadata

  • Download URL: telethon_up-1.3.tar.gz
  • Upload date:
  • Size: 4.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.0

File hashes

Hashes for telethon_up-1.3.tar.gz
Algorithm Hash digest
SHA256 66dab06d7719be75336f06a58eca619700ac738eb337d6e8b3b65f849ecdef11
MD5 f1d5016ffcf03ef7325185029c3c259f
BLAKE2b-256 44e7cb196a5fce846c7f998b8c7bd376be985a0d5cb20b8bca8197f04e189678

See more details on using hashes here.

File details

Details for the file telethon_up-1.3-py3-none-any.whl.

File metadata

  • Download URL: telethon_up-1.3-py3-none-any.whl
  • Upload date:
  • Size: 4.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.0

File hashes

Hashes for telethon_up-1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 1737d58281a894cd46795225c34a9bb678b96229ac042f466b15fe0ad65e2827
MD5 a14350005296f8ab62c6c08e1741a346
BLAKE2b-256 3b685187eb9f984b14f368f0263a23c7ba149f51ed5aea01439bd224d41238f6

See more details on using hashes here.

Supported by

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