Glossary
Terms for Session / TData Export and Format Convert. Auth code and quota details: Auth code & quota.
General Terms
Auth code
Credential for site-wide sign-in and deducting remaining uses. Shared by export and convert. See Auth code & quota.
Session / StringSession
Telethon string session. Export saves it in session.txt; convert accepts .txt upload or paste. Sensitive — do not share.
TData / tdata
Telegram Desktop local data directory (folder tdata/, not a .tdata file). Contains auth keys; equivalent to Session.
ZIP (export)
Download from export. Usually named like 8613988881111.zip with session.txt, account.json, tdata/.
account.json
Account metadata (phone, time, device, has_2fa, profile). No 2FA password plaintext.
Uses remaining / quota
Shared pool for export + convert. Header shows X / Y uses. Success deducts 1; failures do not.
2FA / Cloud Password
Telegram cloud password at login. Not written to export files.
Telethon / Pyrogram / Telegram Desktop
Typical uses: Python libraries with StringSession; Desktop with TData.
Session Export
Job ID
Unique id per export task for status and download. Jobs may expire.
Job status
pending | code_sent | qr_pending | qr_listen_timeout | password_required | building | completed | failed | expired
Country code / login code / QR login
Standard Telegram login flow terms for phone and QR sign-in.
Format Convert
Format convert
Transform Session ↔ tdata without Telegram login. Server does not connect to Telegram. Dead sessions not detected — success does not guarantee login works.
Valid tdata folder
Must contain key_datas and/or files starting with D877F783D5.
ZIP upload detection
Server reads ZIP directory for tdata/ paths or key_datas before extracting and locating the folder.
Session → tdata output
tdata/
├── key_datas
└── D877F783D5…No session.txt or account.json (those are from export, not convert).
Telegram Desktop
- tdata → Session: backup → StringSession
- Session → tdata: StringSession → Desktop folder
Tool does not run or modify Desktop.
Auto detection (direction=auto)
| Content | Direction |
|---|---|
| UTF-8 text (non-ZIP) | Session → tdata |
| ZIP (PK) | tdata → Session |
File names are ignored.
Convert output
| Direction | File | Type |
|---|---|---|
| Session → tdata | converted_tdata.zip | ZIP |
| tdata → Session | converted_session.txt | text |
vs Session Export
- Export: new login via Telegram, full ZIP
- Convert: transform existing Session/tdata, no login
From Session Export
Upload the full export ZIP or paste session.txt — both work for tdata → Session.
Common Errors (Convert)
| Message | Meaning |
|---|---|
| Empty file | No valid upload |
| Unsupported type | Not text or valid ZIP |
| No tdata in ZIP | Missing tdata/ and key_datas |
| Invalid Session | Bad StringSession structure |
| Invalid tdata | Cannot load tdata structure |
| Timeout | Exceeded server limit (~60s) |