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 Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

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

telethon_up-1.3.1-py3-none-any.whl (4.4 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for telethon_up-1.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 ebc2c1cb76cdb4efdf34275d2e53853df950d90d952849161f107d7b5ab50f68
MD5 2d44ce324642b051485c8939516ab39a
BLAKE2b-256 0a512a59cd12a28431a94fa32bb289d0acce27163dafd4ef0c139fb5eaa2e6c7

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