WindyMadman/tdl
1
0
Fork 0
mirror of https://github.com/iyear/tdl synced 2025-01-08 11:57:55 +08:00
Code Issues Packages Projects Releases Wiki Activity

docs(README): add download file template

Browse Source
This commit is contained in:
iyear 2022-10-08 15:38:27 +08:00
parent 2764dfc4cc
commit 9764f3bfa0
1 changed files with 23 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
README.md
View File

@ -103,11 +103,12 @@ tdl login
Advanced Options:
| Flag | Default | Desc |
|:--------------:|:--------------:|:-------------------------------------:|
| `-t/--threads` | 4 | threads for transfer one item |
| `-s/--size` | 128*1024 Bytes | part size for transfer, max is 512KiB |
| `-l/--limit` | 2 | max number of concurrent tasks |
| Flag | Default | Desc |
|:--------------:|:--------------------------------------------------:|:-------------------------------------:|
| `-t/--threads` | 4 | threads for transfer one item |
| `-s/--size` | 128*1024 Bytes | part size for transfer, max is 512KiB |
| `-l/--limit` | 2 | max number of concurrent tasks |
| `--template` | `{{ .DialogID }}_{{ .MessageID }}_{{ .FileName }}` | file name template |
Download (protected) chat files from message urls:
@ -133,6 +134,23 @@ Download with 8 threads, 512KiB(MAX) part size, 4 concurrent tasks:
tdl dl -u https://t.me/tdl/1 -t 8 -s 524288 -l 4
```
Download with custom file name template:
Following the [go template syntax](https://pkg.go.dev/text/template), you can use the variables:
| Var | Desc |
|:------------:|:------------------------------------:|
| DialogID | Telegram dialog id |
| MessageID | Telegram message id |
| MessageDate | Telegram message date(ts) |
| FileName | Telegram file name |
| FileSize | Human-readable file size, like `1GB` |
| DownloadDate | Download date(ts) |
```shell
tdl dl -u https://t.me/tdl/1 --template "{{ .DialogID }}_{{ .MessageID }}_{{ .DownloadDate }}_{{ .FileName }}"
```
Full examples:
```shell
tdl dl --debug --ntp pool.ntp.org -n iyear --proxy socks5://localhost:1080 -u https://t.me/tdl/1 -u https://t.me/tdl/2 -f result1.json -f result2.json -t 8 -s 262144 -l 4