inpowerchiu/tdl

Intro

📥 Telegram Downloader, but more than a downloader 🚀

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

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

# use proxy, only support socks now
tdl --proxy socks5://localhost:1080

# 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

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

inpowerchiu / tdl