Telegram Bot Controller

Это интерфейс командной строки (TUI) для управления вашими Telegram ботами, построенный с использованием Python и библиотеки Textual. Он предоставляет удобный способ взаимодействия с API Telegram для выполнения различных административных задач.

---

Ключевые возможности:

• ** Управление токеном:** Легко устанавливайте, сохраняйте и загружайте токен вашего бота из файла конфигурации (config.ini).
• ** Информация о боте:** Просматривайте основную информацию о боте (ID, имя, юзернейм, статусы доступности функций).
• ** Настройка профиля бота:**
  • Изменение имени бота.
  • Изменение основного описания бота (до 512 символов).
  • Изменение короткого описания "О себе" (до 120 символов).
  • Установка/смена аватара бота (фото профиля) из локального файла (JPG/PNG).
• ** Отправка сообщений:** Отправляйте текстовые сообщения в любой чат по ID или @username. Поддерживается HTML-разметка для форматирования текста.
• ** Спам-функции (Используйте с крайней осторожностью!):**
  • ** Целевой спам:** Отправка множества сообщений в указанный чат с настраиваемым количеством и задержкой между сообщениями.
  • ** Массовый спам:** Рассылка сообщений по всем ID чатов и юзернеймам, найденным в логах активности бота. Настраиваемая задержка и общая продолжительность спам-сессии. Высокий риск бана бота!
• ** Логирование обновлений:** Получение и логирование входящих обновлений (сообщения, колбэки, получение файлов и т.д.) от бота в локальный файл (bot_logs/received_data.log). Помогает отслеживать активность и собирать ID чатов.
• ** Интерактивный TUI:** Удобный и отзывчивый интерфейс с кнопками, полями ввода, модальными окнами и динамическим логом статуса операций, созданный с помощью Textual.
• ** Обработка ошибок:** Встроенная обработка распространенных ошибок Telegram API, включая InvalidToken, BadRequest, NetworkError и автоматическое ожидание при RetryAfter (флуд-контроль).
• ** Управление буфером обмена:** Кнопки "Вставить" в диалоговых окнах для удобного ввода данных (требуется pyperclip).

---

Технологии:

• Python 3.12
• python-telegram-bot (асинхронная версия v20.x+)
• Textual (для создания TUI)
• configparser (для управления конфигурацией)
• pyperclip (опционально, для работы с буфером обмена)

---

Начало работы:

1. Установите зависимости: Создайте файл requirements.txt со следующим содержимым:

   python-telegram-bot>=20.0
   textual
   pyperclip

   Затем установите:

   pip install -r requirements.txt

2. Запустите приложение:

   python BOTcontroller.py

   При первом запуске программа предложит ввести токен вашего Telegram бота. Токен будет сохранен в config.ini для последующих запусков.
3. Используйте интерфейс: Используйте горячие клавиши, указанные рядом с названиями кнопок (например, [T] для токена), или навигацию с помощью клавиатуры/мыши для взаимодействия с функциями.

---

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

• Основной лог работы приложения: BotController.log (содержит информацию о действиях в приложении и ошибках).
• Лог полученных данных от Telegram: bot_logs/received_data.log (сюда записываются все входящие обновления от бота: сообщения, информация об отправленных файлах, колбэки и т.д.).

---