opentele-py313 1.15.2

A Python 3.13+ compatible fork of opentele - Telegram API Library for converting between tdata and telethon sessions.

opentele-py313

Python 3.13+ Compatible Fork

This is a Python 3.13+ compatible fork of the original opentele library by thedemons.

What's Changed?

• Python 3.13 Compatibility: Fixed compatibility issues with Python 3.13 by handling new class attributes (__firstlineno__ and __static_attributes__) in the extend_class decorator.
• All original functionality remains intact.

Original Project

This fork is based on opentele v1.15.1. All credit for the original library goes to thedemons.

Original repository: https://github.com/thedemons/opentele

---

Features

• Convert Telegram Desktop tdata sessions to telethon sessions and vice versa.
• Use telethon with official APIs to avoid bot detection.
• Randomize device info using real data that recognized by Telegram server.

Dependencies

• telethon - Widely used Telegram's API library for Python.
• tgcrypto - AES-256-IGE encryption to works with tdata.
• pyQt5 - Used by Telegram Desktop to streams data from files.

Installation

For Python 3.13+

Install this fork from PyPI:

pip install --upgrade opentele-py313

For Python 3.12 and below

Use the original library:

pip install --upgrade opentele

First Run

Load TDesktop from tdata folder and convert it to telethon, with a custom API:

from opentele.td import TDesktop
from opentele.tl import TelegramClient
from opentele.api import API, CreateNewSession, UseCurrentSession
import asyncio

async def main():
    
    # Load TDesktop client from tdata folder
    tdataFolder = r"C:\Users\<username>\AppData\Roaming\Telegram Desktop\tdata"
    tdesk = TDesktop(tdataFolder)

    # Using official iOS API with randomly generated device info
    # print(api) to see more
    api = API.TelegramIOS.Generate()

    # Convert TDesktop session to telethon client
    # CreateNewSession flag will use the current existing session to
    # authorize the new client by `Login via QR code`.
    client = await tdesk.ToTelethon("newSession.session", CreateNewSession, api)

    # Although Telegram Desktop doesn't let you authorize other
    # sessions via QR Code (or it doesn't have that feature),
    # it is still available across all platforms (APIs).

    # Connect and print all logged in devices
    await client.connect()
    await client.PrintSessions()

asyncio.run(main())

Authorization

opentele offers the ability to use official APIs, which are used by official apps. You can check that out here.

According to Telegram TOS: all accounts that sign up or log in using unofficial Telegram API clients are automatically put under observation to avoid violations of the Terms of Service.

It also uses the lang_pack parameter, of which telethon can't use because it's for official apps only.
Therefore, there are no differences between using opentele and official apps, the server can't tell you apart.

Incoming Features

• Writing data to tdata for converting telethon sessions to tdesktop.
• Random device information for initConnection to avoid spam-detection.
• Add support for pyrogram.
• Develop opentele-tui using textual for non-experience user.

Examples

The best way to learn anything is by looking at the examples. Am I right?

• Example on readthedocs
• Example on github

Documentation

• Read documentation on readthedocs
• Read documentation on github