Quick Start #

Login #

We don’t specify the namespace here, so it will use the default namespace. You can specify the namespace with -n flag if you want to use another namespace.

Login with desktop clients #

Please ensure that clients are downloaded from official website (NOT from Microsoft Store or App Store)

Automatically find the client path:

tdl login

Or if you set a local passcode:

tdl login -p YOUR_PASSCODE

Or specify custom client path:

tdl login -d /path/to/TelegramDesktop

Login with QR code #

tdl login -T qr

Login with phone & code #

tdl login -T code

Verify Setup #

After logging in, you can verify your setup is working correctly:

tdl doctor

This will check your time synchronization, connectivity, database, and login status. See Doctor for more details.

Download #

We download media from Telegram official channel:

tdl dl -u https://t.me/telegram/193