Telegram Cleaner 🧹

Инструмент для массовой очистки Telegram аккаунта от нежелательных контактов, каналов и групп.

⚠️ ВНИМАНИЕ

Этот инструмент выполняет НЕОБРАТИМЫЕ действия!

• Удаляет все диалоги и историю сообщений
• Покидает все каналы и группы
• Удаляет контакты из списка
• Опционально блокирует удаленных пользователей

Используйте на свой страх и риск!

🚀 Возможности

• ✅ Массовое удаление диалогов
• ✅ Выход из каналов и групп
• ✅ Удаление контактов
• ✅ Настраиваемый белый список
• ✅ Режим "сухого запуска" для предварительного просмотра
• ✅ Опциональная блокировка удаленных пользователей
• ✅ Поддержка сессионных строк
• ✅ Подробное логирование

📋 Требования

• Python 3.7+
• Telegram API ключи (API_ID и API_HASH)
• Библиотека Telethon

🔧 Установка

1. Клонируйте репозиторий:

git clone https://github.com/your-username/telegram-cleaner.git
cd telegram-cleaner

2. Установите зависимости:

pip install telethon

3. Получите API ключи Telegram:
   • Перейдите на https://my.telegram.org
   • Войдите в свой аккаунт
   • Создайте новое приложение
   • Скопируйте api_id и api_hash

⚙️ Настройка

1. Отредактируйте файл telegram_cleaner.py:

   • Замените API_ID и API_HASH на ваши реальные значения
   • Настройте белый список в WHITELIST_ENTITIES

2. Настройте белый список:

WHITELIST_ENTITIES = [
    "SpamBot",  # Username Spam Info Bot
    777000,     # ID официального аккаунта Telegram
    # Добавьте сюда username или ID, которые нужно сохранить
]

🎯 Использование

Базовое использование:

python telegram_cleaner.py

С параметрами:

python telegram_cleaner.py --api_id YOUR_API_ID --api_hash YOUR_API_HASH --dry-run

Доступные параметры:

• --api_id - Ваш Telegram API ID
• --api_hash - Ваш Telegram API Hash
• --session-name - Имя файла сессии (по умолчанию: my_cleaner_session)
• --session-string - Сессионная строка для авторизации
• --dry-run - Режим предварительного просмотра (без реальных изменений)
• --block - Блокировать удаленных пользователей

🔒 Безопасность

• Никогда не делитесь вашими API ключами
• Всегда используйте режим --dry-run сначала
• Внимательно проверяйте белый список перед запуском
• Создайте резервную копию важных данных

📝 Логирование

Скрипт выводит подробную информацию о каждом действии:

• Количество обработанных диалогов
• Названия удаляемых каналов/групп
• Статус выполнения операций
• Ошибки и предупреждения

⚡ Первый запуск

При первом запуске потребуется авторизация:

1. Введите номер телефона в международном формате
2. Введите код подтверждения из Telegram
3. Если включена 2FA, введите пароль

🛡️ Белый список

Автоматически добавляются в белый список:

• Ваш собственный аккаунт (Saved Messages)
• SpamBot (официальный бот)
• Telegram (служебные уведомления)

📄 Лицензия

MIT License - используйте на свой страх и риск.

⚠️ Отказ от ответственности

Автор не несет ответственности за любые потери данных или другие последствия использования этого инструмента. Используйте только на своих аккаунтах и только если вы понимаете все риски.

🤝 Вклад в проект

Если вы нашли ошибку или хотите предложить улучшение, создайте Issue или Pull Request.

---

Удачной очистки! 🧹✨