Skip to main content

Telegram Cleaner ♻️

Delete all your messages of any type.

🇷🇺 RUSSIAN DISCLAIMER: Telegram не является анонимным и никогда им не был. Сотрудникам спецслужб известны телефонные номера около 30 миллионов пользователей Telegram из России, а равно и паспортные данных их владельцев. До 2020 года по телефону можно было найти любого пользователя. Чекистские подстилки массово скупали симки, вбивали в контакты тысячи случайных номеров, а потом сохраняли в базе связку id пользователя и номера телефона. Так собиралась пользовательская база, например, «Глаза Бога» 👁️. С учетом того, что Роскомнадзор запустил бота для поиска экстремистских комментариев в сети, в т.ч. в Telegram, я настоятельно рекомендую вам потереть свои старые комментарии в каналах и группах ДАЖЕ ЕСЛИ ВАС НЕТУ В БАЗАХ БОТОВ ДЛЯ ПРОБИВА. Помните, что Telegram сотрудничает с ФСБ и другими спецслужбами и сливает данные тех же террористов, наркоторговцев... и даже распространителей слухов в Индии. Если сотрудники телеги получат на вас запрос от гэбни, то весьма вероятно никто из них не удосужится выяснить, настоящий вы ли террорист или же это обычный спам запросами на неугодных режиму, они просто передадут ваши ip-адрес и номер телефона.

⚠️ WARNING: before using this utility, you can save all your data using the desktop application: Settings > Advanced > Export Telegram data.

Installation:

# via pip
$ pip install -U telegram-cleaner

# via pipx
$ pipx install telegram-cleaner

Usage:

# help
$ tg-clean -h

# first save your chats because the data exported by telegram does not have information about group and user IDs
$ tg-clean dump_chats > mychats.json

# you can extract data from this file using jq
$ jq -r '.[] | "\( .id ) \( .username  ) " +
  if has("title")
    then .title
    else "\( .first_name ) \( .last_name  )"
  end' mychats.json
777000 null Telegram null
-1001436354653 nwsru NEWS.ru | Новости
...

# delete messages in group chats, comments, posts
$ tg-clean -vv delete_group_messages

# delete private chats without confirmation
$ tg-clean -y delete_private_chats

# delete all your messages of any type in chats except those specified
$ tg-clean --keep-chats 1234567890,1234567891,@durovs

You can use custom API_ID and API_HASH (official apps). Add this lines to ~/.bashrc or ~/.zshrc:

export TG_API_ID=6
export TG_API_HASH=eb06d4abfb49dc3eeb1aeb98ae0f581e

Also you can use .env file with zsh dotenv plugin.

Metadata

Release files for telegram-cleaner 0.1.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for telegram-cleaner 0.1.5
File Size Uploaded
telegram_cleaner-0.1.5.tar.gz 6.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for telegram-cleaner 0.1.5
File Interpreter ABI Platform
telegram_cleaner-0.1.5-py3-none-any.whl Python 3 none any Details

Total release size: 14.9 kB

Release files / telegram_cleaner-0.1.5.tar.gz

Download URL telegram_cleaner-0.1.5.tar.gz
Size 6.6 kB
Tags Source
SHA-256 checksum
How to use checksums
b7163b609f2ec3b6fc24564342e6103dd0ea24777f83726c2720e5076bfb4de5
BLAKE2b-256 checksum
How to use checksums
db21db5fcddf2061b171f094016221bf5943bd5a4720d2811858e55b1aee6f0e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.8.3 CPython/3.12.4 Linux/6.9.5-arch1-1

Release files / telegram_cleaner-0.1.5-py3-none-any.whl

Download URL telegram_cleaner-0.1.5-py3-none-any.whl
Size 8.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
72d55e6d6f7abda6137fdff660593b4332276e7fdfa8fc08e81978aedc9f98f4
BLAKE2b-256 checksum
How to use checksums
9a25d39b191ef7f2190ba5ff45528f0d3bb822ea10b6a0a7004f2d09aa193e95
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.8.3 CPython/3.12.4 Linux/6.9.5-arch1-1

Release history Release notifications | RSS feed

This release

0.1.5 This release

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page