opentele-tg 3.13.1

A Python Telegram API library based on the original OpenTele project by thedemons, for converting between tdata and Telethon sessions with built-in official Telegram APIs.

opentele

Fork of thedemons/opentele with Python 3.13 compatibility, updated device spoofing and QR Code login.

A Python Telegram API Library for converting between tdata and telethon sessions, with built-in official Telegram APIs. Read the documentation.

---

What's changed from the original

Python 3.13 compatibility

• Fixed crossDelete in utils.py to handle new dunder attributes introduced in Python 3.13 (__firstlineno__, __static_attributes__, __dict__, __weakref__, __qualname__)
• Fixed _on_login calls in tl/telethon.py that broke under Python 3.13's coroutine handling
• Removed deprecated TDesktop storage keys (customEmoji, searchSuggestions, webviewTokens) that caused parsing errors with recent tdata versions

QR Code login

• Added a new session creation method via QR Code scan, no need to convert tdata or existing session files
• The app generates a QR code in the terminal, the user scans it from the official Telegram app on their phone, and the session is authorized automatically
• Supports 2FA (two-factor authentication) if enabled on the account

Updated device spoofing logic

• Replaced the hardcoded device list with a structured system that maps real Android SDK versions to devices that officially support that version
• Each Android version (Android 13/SDK 33, Android 14/SDK 34, Android 15/SDK 35) is mapped to real devices that were officially released or updated to that version
• Updated app version from 8.4.1 to 12.5.1 to match current official Telegram Android
• Added DeviceInfo.to_dict() and DeviceInfo.from_dict() methods for serialization
• Added ResolveDevice() method that allows passing a specific device instead of always randomizing

Other changes

• Changed isinstance check to type() comparison in APIData.__eq__ to avoid false positives with subclasses

Platform support

Platform	Status
Linux	✅ Tested on Python 3.13

---

NOTICE

Unfortunately, due to the lack of interest, I can no longer maintain this project and keep it up-to-date with the latest version of Telegram Desktop and Telethon.
If you have been using opentele for a while, I appreciate it, please consider contributing to the project, ask any questions in Discussion and I'll try to help.

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.
• qrcode - QR code generation for terminal-based login.

Installation

• Install from PyPI:

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())

QR Code Login (New)

Create a session by scanning a QR code from the official Telegram app. No tdata or session file conversion needed.

from opentele.tl import TelegramClient
from opentele.api import API
from telethon.errors import SessionPasswordNeededError
from getpass import getpass
import qrcode
import asyncio
import os

async def main():
    os.makedirs("sessions", exist_ok=True)
    session_path = "sessions/my_account.session"
    api = API.TelegramAndroid.Generate(unique_id=session_path)
    client = TelegramClient(session_path, api=api)

    await client.connect()

    if await client.is_user_authorized():
        print("Session already authorized.")
        await client.disconnect()
        return

    qr_login = await client.qr_login()

    # Generates a QR code in the terminal
    qr = qrcode.QRCode(border=1)
    qr.add_data(qr_login.url)
    qr.make(fit=True)
    print("\nScan this QR from Telegram on your phone:\n")
    qr.print_ascii(invert=True)

    try:
        await qr_login.wait()
    except SessionPasswordNeededError:
        password = getpass("2FA Password: ")
        await client.sign_in(password=password)

    if await client.is_user_authorized():
        print("Session created successfully.")
        me = await client.get_me()
        if me:
            print(f"User: {me.id} | {me.first_name}")
        await client.PrintSessions()
    else:
        print("Could not authorize the session.")

    await client.disconnect()

asyncio.run(main())

Note: Requires qrcode package: pip install qrcode

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.
• QR Code login without tdata or session conversion.
• 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