Glossary

Format convert

Transform existing Session ↔ tdata without Telegram login.

StringSession

Telethon session string, usually one line. Upload as text or paste on the page.

tdata

The directory Telegram Desktop uses for local login state — sensitive, equivalent to Session.

Valid tdata folder

Must contain key_datas and/or files starting with D877F783D5 (Desktop account mapping).

Empty folders or configs without these markers cannot convert to Session.

ZIP upload detection

Before full extraction, the server reads the ZIP central directory for:

• Path segments tdata/ (e.g. tdata/key_datas, 8613988881111/tdata/…), or
• Any file named key_datas

Then it extracts and locates the tdata folder (root, nested, or inside export account folders).

Session → tdata output

tdata/
├── key_datas
└── D877F783D5…

Output ZIP contains tdata/ only — no session.txt or account.json (those are from Session Export, not convert).

Telegram Desktop

• tdata → Session: Desktop backup → StringSession
• Session → tdata: StringSession → Desktop-compatible folder

This tool does not run or modify Telegram Desktop; import is done on your machine.

Common tdata issues

Message	Meaning
No tdata in ZIP	Missing tdata/ paths and key_datas — repack per How to Use
No valid tdata directory	No folder with valid markers after extract
Invalid tdata	Corrupt/incomplete backup or version mismatch
Session invalid for tdata	Session revoked — need new login/export
Desktop won’t login after import	Version/path issue — backup and check Desktop docs

From Session Export

Upload the full export ZIP (has …/tdata/) or paste session.txt — both work for tdata → Session.

Auto detection (direction=auto)

Content	Direction
UTF-8 text (non-ZIP)	Session → tdata
ZIP (PK)	tdata → Session

File names are ignored.

Output files

Direction	File	Type
Session → tdata	converted_tdata.zip	ZIP
tdata → Session	converted_session.txt	text

Quota

Shared with Session Export. Success deducts 1 use. Auth code & quota

Related

• Introduction · Session Export glossary