Export Messages

Export Messages #

Export media messages from chats, channels, groups, etc. in JSON format.

CHAT Examples

Available Values: #

  • @iyear (Username)
  • iyear (Username without @)
  • 123456789 (ID)
  • https://t.me/iyear (Public Link)
  • +1 123456789 (Phone)

How to Get Chat ID on Telegram Desktop: #

  • SettingsAdvancedExperimental settingsShow Peer IDs in Profile
Empty CHAT means ‘Saved Messages’

All #

Export all messages containing media to tdl-export.json

tdl chat export -c CHAT

From Topic/Replies #

Export media messages from specific topic:

Get Topic ID:

  1. Message Link: https://t.me/c/1492447836/251011/269724 (251011 is topic id)
  2. tdl chat ls command

tdl chat export -c CHAT --topic TOPIC_ID

Export media messages from specific channel post replies:

tdl chat export -c CHAT --reply POST_ID

Custom Destination #

Export with specific output file path. Default: tdl-export.json.

tdl chat export -c CHAT -o /path/to/output.json

Custom Type #

Time Range #

Export with specific timestamp range. Default: 1970-01-01 - NOW

tdl chat export -c CHAT -T time -i 1665700000,1665761624

time is also the default value of -T option, so you can omit it

tdl chat export -c CHAT -i 1665700000,1665761624

ID Range #

Export with specific message id range. Default: 0 - latest

tdl chat export -c CHAT -T id -i 100,500

Last #

Export last 100 media messages:

tdl chat export -c CHAT -T last -i 100

Filter #

Please refer to Filter Guide for basic knowledge about filter.

List all available filter fields:

tdl chat export -c CHAT -f -

Export last 10 zip files that size > 5MiB and views > 200:

tdl chat export -c CHAT -T last -i 10 -f "Views>200 && Media.Name endsWith '.zip' && Media.Size > 5*1024*1024"

With Content #

Export with message content:

tdl chat export -c CHAT --with-content

Raw #

Export Telegram MTProto raw message structure, which is useful for debugging.

tdl chat export -c CHAT --raw

Non-Media #

Export all messages including non-media messages, which is useful for debugging/backup.

tdl chat export -c CHAT --all