{"id":13988843,"url":"https://github.com/TelegramTools/TLImporter","last_synced_at":"2025-07-22T09:31:35.490Z","repository":{"id":37470856,"uuid":"121647149","full_name":"TelegramTools/TLImporter","owner":"TelegramTools","description":"📲 Telegram Chat Importer: Import chats from WhatsApp or other services into Telegram","archived":true,"fork":false,"pushed_at":"2021-04-30T21:15:03.000Z","size":2788,"stargazers_count":126,"open_issues_count":8,"forks_count":11,"subscribers_count":11,"default_branch":"python","last_synced_at":"2024-11-29T07:37:01.599Z","etag":null,"topics":["chats","conversation","telegram","tltools","whatsapp"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TelegramTools.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-02-15T15:41:39.000Z","updated_at":"2024-08-30T12:42:04.000Z","dependencies_parsed_at":"2022-09-05T21:10:55.342Z","dependency_job_id":null,"html_url":"https://github.com/TelegramTools/TLImporter","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/TelegramTools/TLImporter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TelegramTools%2FTLImporter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TelegramTools%2FTLImporter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TelegramTools%2FTLImporter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TelegramTools%2FTLImporter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TelegramTools","download_url":"https://codeload.github.com/TelegramTools/TLImporter/tar.gz/refs/heads/python","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TelegramTools%2FTLImporter/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266465090,"owners_count":23933064,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-22T02:00:09.085Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["chats","conversation","telegram","tltools","whatsapp"],"created_at":"2024-08-09T13:01:23.596Z","updated_at":"2025-07-22T09:31:34.047Z","avatar_url":"https://github.com/TelegramTools.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/TelegramTools/TLImporter/raw/python/images/Intro.png\"\u003e\n \u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/TelegramTools/TLSecret/raw/master/images/SecretModeLabel.png\"\u003e\n \u003c/p\u003e\n\n# TLImporter - Telegram Chat Importer\n\nThis app will import your conversations from WhatsApp or other services (using a _txt_ file obtained from the chat provider) into Telegram. With TLImporter you can import your messages into your \"Saved Messages\" section or do it in a 1:1 format. That means that you will need to log in your partner's Telegram's account inside TLImporter and it will automatically send the corresponding messages to each other, keeping the original structure.\n\nBriefly, Telegram Chat Importer can turn your exported plaintext conversations into a 1:1 format like this:\n\n![](/images/txt.PNG)\n\nInto this:\n\n![](/images/ImportedChat.PNG)\n\n## How to use?\n\nEasy! Start over [here](https://github.com/TelegramTools/TLImporter/wiki/Getting-your-chats-from-third-party-services) and follow the steps in the guide. You will be a master using the app in seconds!\n\n## Documentation\n\nYou can check the full documentation, examples, building instructions, FAQs and a detailed guide in [the wiki](https://github.com/TelegramTools/TLImporter/wiki)\n\n## Download\n\nYou can always grab the latest version heading over the [releases tab](https://github.com/TelegramTools/TLImporter/releases).\nI built binaries for **Windows (64 bits)**, **Linux amd64** and **Linux armhf**\n\n* On **Windows**: Simply double click on the ``.exe`` file\n* On **Linux**: Download the binary, ``cd`` to the folder where the download is located and do ``chmod +x TLImporter-xxx \u0026\u0026 ./TLImporter-xxx``\n\nIf you're running other systems (like MacOS), you will need to **build the files from source**.\n\n## Build from sources\n\nMake sure that you replace the ``api_id`` and ``api_hash`` variables in the ``TLImporter.py`` file.\nRead instructions [here](https://core.telegram.org/api/obtaining_api_id) for getting your own from Telegram.\n\nYou can't use Secret Mode if one of the sides is still using the binaries: I'm the only holder of the encryption key, so it's more\ndifficult for malicious people to compromise them. If you want to use the *Secret Mode*, you must build both TLImporter and TLSecret from\nsources using the same password for it to work. You can specify the password used for encryption/decryption in the ``password`` variable.\n\n## Credits\n\nThis couldn't be possible without [Telethon](https://github.com/LonamiWebs/Telethon), and his great creator, [Lonami](https://github.com/Lonami), who always was up to answering questions and helping in development. I'm so grateful for his patience :).\n\nThanks to the [PyInstaller](https://www.pyinstaller.org/) team for their great tool, which I used to build the binaries.\n\nAlso, huge acknowledgements to Telegram for making such a great messenger!\n\n**Give always credits to all the original authors and owners when using some parts of their hard work in your own projects**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FTelegramTools%2FTLImporter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FTelegramTools%2FTLImporter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FTelegramTools%2FTLImporter/lists"}