mirror of
https://github.com/bit1001/tdl.git
synced 2024-09-20 06:35:54 +08:00
88 lines
2.4 KiB
Markdown
88 lines
2.4 KiB
Markdown
## Intro
|
|
|
|
![](https://img.shields.io/github/go-mod/go-version/iyear/tdl?style=flat-square)
|
|
![](https://img.shields.io/github/license/iyear/tdl?style=flat-square)
|
|
![](https://img.shields.io/github/workflow/status/iyear/tdl/master%20builder?style=flat-square)
|
|
![](https://img.shields.io/github/v/release/iyear/tdl?color=red&style=flat-square)
|
|
![](https://img.shields.io/github/last-commit/iyear/tdl?style=flat-square)
|
|
|
|
📥 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**
|
|
|
|
![](img/preview.gif)
|
|
|
|
## Install
|
|
|
|
Go to [GitHub Releases](https://github.com/iyear/tdl/releases) to download the latest version
|
|
|
|
## Usage
|
|
|
|
```shell
|
|
# 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
|
|
tdl login -n iyear
|
|
|
|
# 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](docs/command/tdl.md) 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](https://github.com/iyear/tdl/issues/new)
|
|
|
|
## 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.
|
|
|
|
## LICENSE
|
|
|
|
AGPL-3.0 License
|