Installation
sudo apt install virtualenv
git clone https://github.com/ivlevdenis/tgdump.git
cd tgdump
chmod a+x tgdump
python3.5
virtualenv -p python3.5 venv
python3.6
virtualenv -p python3.6 venv
source venv/bin/activate
pip install -r requirements.txt
Usage
cd PATH/TO/tgdump
source venv/bin/activate
./tgdump --help
usage: tgdump [-h] --entities ENTITIES [--output OUTPUT] [--phone PHONE]
[--api-id API_ID] [--api-hash API_HASH] [--session SESSION]
[--senders SENDERS] [--limit LIMIT] [--offset-date OFFSET_DATE]
[--offset-id OFFSET_ID] [--max-id MAX_ID] [--min-id MIN_ID]
Dump Telegram messages. Suports User, Chat, Channel peers. ATTENTION! Do not
support pipes!
optional arguments:
-h, --help show this help message and exit
--entities ENTITIES Comma separated list of entities or filename. Support
phone (string statrted with '+'), username (started
with '@'), or integer ID for chats or channel.
--output OUTPUT Output JSON filename.
--phone PHONE International format phone number '+79998887766'. If
not specified, the environment variable PHONE is used.
--api-id API_ID API_ID can get by link my.telegram.org/apps. If not
specified, the environment variable API_ID is used.
--api-hash API_HASH API_HASH can get by link my.telegram.org/apps. If not
specified, the environment variable API_HASH is used.
--session SESSION Name of session, used for session filename, If not
specified, used teporary session.
--senders SENDERS If specified, then include serder info to 'peer' as
'meta' param.
--limit LIMIT Number of messages to be retrieved. Due to limitations
with the API retrieving more than 3000 messages will
take longer than half a minute (or even more based on
previous calls). The limit may also be None, which
would eventually return the whole history.
--offset-date OFFSET_DATE
Offset date (messages *previous* to this date will be
retrieved). Example 01.01.2017.
--offset-id OFFSET_ID
Offset message ID (only messages *previous* to the
given ID will be retrieved).
--max-id MAX_ID All the messages with a higher (newer) ID or equal to
this will be excluded.
--min-id MIN_ID All the messages with a lower (older) ID or equal to
this will be excluded.