Intro

📥 Telegram Downloader, but more than a downloader 🚀

⚠ Note: Command compatibility is not guaranteed in the early stages of development

⚠ Warning: some accounts have been blocked, so please use carefully. Go to ISSUE for discussion

Features

• Single file start-up
• Low resource usage
• Take up all your bandwidth
• Faster than official clients
• Download files from (protected) chats
• Upload files to Telegram

Preview

It reaches my proxy's speed limit, and the speed depends on whether you are a premium

Install

Go to GitHub Releases to download the latest version

Usage

# get help
tdl -h

# check the version
tdl version

# specify the namespace
tdl -n iyear
# or
export TDL_NS=iyear

# use proxy, only support socks now
tdl --proxy socks5://localhost:1080
# or
export TDL_PROXY=socks5://localhost:1080

# set ntp server, if not set, use system time
tdl --ntp pool.ntp.org
# or
export TDL_NTP=pool.ntp.org

# login your account with a name, default is phone & code mode
tdl login -n iyear

# if you have official desktop client on machine, you can import its session
# may be use official session can reduce ban risk(no guarantee)
tdl login -n iyear-desktop -d /path/to/Telegram

# list your chats
tdl chat ls -n iyear

# download files in url mode, url is the message link
tdl dl url -n iyear -u https://t.me/tdl/1 -u https://t.me/tdl/2

# full examples in download url mode
tdl dl url -n iyear --proxy socks5://localhost:1080 -u https://t.me/tdl/1 -u https://t.me/tdl/2 -s 262144 -t 16 -l 3

# upload files to 'Saved Messages', exclude the specified file extensions
tdl up -n iyear -p /path/to/file -p /path -e .so -e .tmp

# full examples in upload mode
tdl up -n iyear --proxy socks5://localhost:1080 -p /path/to/file -p /path -e .so -e .tmp -s 262144 -t 16 -l 3

Env

Avoid typing the same flag values repeatedly every time by setting environment variables.

Note: The values of all environment variables have a lower priority than flags.

What flags mean: flags

NAME	FLAG
TDL_NS	-n/--ns
TDL_PROXY	--proxy
TDL_DEBUG	--debug
TDL_SIZE	-s/--size
TDL_THREADS	-t/--threads
TDL_LIMIT	-l/--limit
TDL_NTP	--ntp

Data

Your account information will be stored in the ~/.tdl directory.

Commands

Go to command documentation for full command docs.

Contribute

• Better command input
• Better interaction
• Better mode support
• ......

Please provide better suggestions or feedback for the project in the form of SUBMIT ISSUE

FAQ

Q: Is this a form of abuse?

A: No. The download and upload speed is limited by the server side. Since the speed of official clients usually does not reach the account limit, this tool was developed to download files at the highest possible speed.

Q: Will this result in a ban?

A: I am not sure. All operations do not involve dangerous actions such as actively sending messages to other people. But it's safer to use an unused account for download and upload operations.

LICENSE

AGPL-3.0 License