Skip to content

Commit 22b9ce5

Browse files
committed
docs(README): add chat export
1 parent 823e481 commit 22b9ce5

2 files changed

Lines changed: 25 additions & 1 deletion

File tree

README.md

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -213,6 +213,21 @@ List all your chats:
213213
tdl chat ls
214214
```
215215

216+
Export minimal JSON for tdl download (NOT for backup):
217+
218+
```shell
219+
# will export all media files in the chat.
220+
# chat input examples: `@iyear`, `iyear`, `123456789`(chat id), `https://t.me/iyear`, `+1 123456789`
221+
222+
tdl chat export -c CHAT_INPUT
223+
224+
# specify the time period with timestamp format, default is start from 1970-01-01, end to now
225+
tdl chat export -c CHAT_INPUT --from 1665700000 --to 1665761624
226+
227+
# specify the output file path, default is `tdl-export.json`
228+
tdl chat export -c CHAT_INPUT -o /path/to/output.json
229+
```
230+
216231
## Env
217232

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

docs/desktop_export.md

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,15 @@
11
## Get desktop clients exported JSON
22

3-
1. Choose the dialog you want to export, and click the three dots in the upper right corner, then click `Export Chat History`.
3+
There are two ways to export the JSON you need
4+
5+
### TDL (especially for protected chats)
6+
7+
Please refer to [README](../README.md#chat-utilities)
8+
9+
### Official desktop clients
10+
11+
1. Choose the dialog you want to export, and click the three dots in the upper right corner, then
12+
click `Export Chat History`.
413

514
2. Uncheck all boxes(you don't need to download them now) and set `Size Limit` to minimum
615

0 commit comments

Comments
 (0)