Skip to content

Introduction

Session / TData Format Convert converts between StringSession text and tdata ZIPno Telegram login.

Visit: tele.xiaohutou.topFormat Convert tab

What it does

InputOutput
Session text (file or paste)tdata ZIP (contains tdata/ folder)
ZIP with tdataSession text file

Detection is content-based, not by file name.

About TData

TData is the folder Telegram Desktop uses to store local login state — a set of key and mapping files, not a single “.tdata file”. This tool converts a Desktop-compatible tdata directory, not arbitrary Telegram install data.

What’s inside a valid tdata folder

A valid tdata directory has at least one of:

MarkerDescription
key_datasCommon key file inside the tdata folder
Files starting with D877F783D5…Desktop account mapping files (fixed prefix, suffix varies)

After Session → tdata, the downloaded ZIP looks like:

converted_tdata.zip
└── tdata/
    ├── key_datas
    ├── D877F783D5D3EF8C…   (example)
    └── …

Extract tdata/ for Telegram Desktop import (backup your existing data first).

How to pack tdata for upload

Upload a ZIP to run tdata → Session. Name does not matter. Supported layouts:

Pack styleExample paths inside ZIPSupported
Zip the tdata folder onlytdata/key_datasYes
Zip Session Export account folder8613988881111/tdata/key_datasYes (server finds tdata recursively)
Nested tdata anywherebackup/xxx/tdata/…Yes
Folder with key_datas but not named tdatasome_folder/key_datasYes (marker-based lookup)

Do not upload: password-protected ZIP, ZIP without tdata/key_datas, corrupt/empty ZIP, or files over the size limit (default 20MB).

vs Session Export ZIP

Session Export ZIPConvert Session → tdata
Contentssession.txt + account.json + tdata/tdata/ only
SourceOnline Telegram loginExisting StringSession

You can upload a full export ZIP for tdata → Session, or paste session.txt instead.

When tdata / Session fails

  • Expired Session → Session → tdata fails
  • Incomplete tdata backup → “Invalid tdata” / “No valid tdata directory”
  • ZIP without tdata paths → rejected before conversion

The tool does not log into Telegram or repair revoked sessions.

Key features

  • Bidirectional Session ↔ tdata
  • No phone / QR login
  • Shared auth code with Session Export

Workflow

  1. Site sign-in
  2. Upload or paste → Start conversion → download

See How to Use.