Java app to download all your telegram data.
Copyright 2016 Fabian Schlenz
Licensed under GPLv3
The tool is working, but not really as intended: Media files in most cases can't be downloaded, message downloads are hit with 30 second delays after every 200 messages. Some users reported getting banned by Telegram without reason after using this tool (with many users not getting banned at the same time, so this could theoretically just be a coincidence).
At the same time, the official Telegram client has an official way to download one's data, which is a) officially supported and b) much, much, much faster than this tool.
Fixing this tool to at least get it to work again as planned would require more or less a complete rewrite of this code. Since I'm quite happy with the possibilities given by the official clients and don't have enough free time to spare to continue developing this project, I've decided to officially archive this tool. This is not an easy step for me, because this was my most used project and quite a lot of people wrote me nice messages and thanked me. But just keeping the user's hopes up for an update without really being able to do something doesn't seem fair. So...
So long, and thanks for all the fish. ;-) \ Fabian
This is a small Java app that allows you to download all your history from Telegram's servers and keep a local copy of them.
You can find the whole app packed into one fat jar file under releases.
This tool relies on Telegram's API. They started rate limiting the calls made by this tool some time ago. As of February 2017, downloading messages is limited to 400 messages every 30 seconds, resulting in 48,000 messages per hour. Media download is not throttled right now, so it should be a lot quicker.
But since this tool is designed to be able to continue it's work at any time, you can just abort the download and continue it later - that way, you'll be moving step by step towards a complete archive of your telegram messages and media files.
You need to have at least Java 1.7 installed on your machine. Download the jar file, and run it on the console like this:
java -jar telegram_backup.jar.
--helpto get a list of all available commands.
Basically, you have to call it with
--loginfirst to login to your telegram account and then call it again with
--accountto use this account and download all it's history. If you have just one account, you can omit this parameter.
--with-supergroupsand / or
--with-channelsto also download all messages from the supergroups / channels you have joined that have been active in the last time.
After making a backup, call it again with
--export htmlto create a few more-or-less nice to look at HTML files containing all your chats. They will be created in the subfolder
filesof your backup. You can just open the file index.html in your browser to look at the files.
I've put quite some time into this tool. If you want to donate a small amount, you can send it via Bitcoin to 1CofYzS88iEngxMu4NqQeohWDBUHv9CNDJ or via PayPal to [email protected].
If you have questions or comments or need help, you can join the telegram_backup Development group at Telegram.
The library I'm using to access Telegram has some small bugs. One of those is the display of meaningless (because they are being acted accordingly upon) error messages. Those include: *
Exception in thread "pool-x-thread-y" java.lang.Error: java.nio.channels.ClosedChannelException* Something containing
AUTH_ERRORYou can just ignore these messages.
Basically, if the tool is continuing to run after error messages are shown, you can just ignore the messages. Either way, even if Telegram_Backup would "miss" some files or messages, this will be detected at the next run of this program and then tried again.
The files are being saved in your User directory in a folder named
telegram_backup. Under windows, this would typically be under
C:\Users\\telegram_backup. Linux users should look unter
You can change this directory by supplying
--targetwhen calling Telegram_Backup.
In the folder
telegram_backupis one folder named
stickers, which will hold all sticker images you've received. Then there is a folder for each account, named after the phone number associated with that account.
In these folders you will find
dc.dat, which contain authentication data. There is
database.sqlitewhich is a SQLite3 database containing all your messages and other data. The folder
filescontains all media files, named after the ID of the message they belong to. Last but not least the folder
exportcontains exported data.
If you are a member of a normal group (non-supergroup), all messages sent to that group are being copied to your personal messages at Telegram's servers.
If you later leave this group, those messages are being deleted at Telegram, but since all messages are continuously numbered, you can't simply delete them because that would leave a hole in your message numbers. So these messages are instead replaced by EmptyMessages - those things contain zero information, they are just saying "here was a message but it was deleted".
This tool uses libraries from other developers which are covered by other licenses, which are: * Kotlogram by Yannick Badoual, licensed under MIT License. * SQLite JDBC by Taro L. Saito, licensed under Apache License version 2.0. * Mustache.java by RightTime, Inc., licensed under Apache License version 2.0. * Logback by QOS.ch, licensed unter LGPL version 2.1. * SLF4J by QOS.ch, licensed under MIT license.