Skip to content

Latest commit

 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 

Repository files navigation

📊 Telegram Radar

HTML Python Telethon CLI

Продвинутый инструмент для мониторинга и управления Telegram группами с красивым интерфейсом и мощными функциями экспорта.


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

📊 Мониторинг и статистика

  • Мониторинг в реальном времени - отслеживание сообщений группы с автоматическим экспортом в Excel
  • Полная статистика группы - участники, админы, боты, сообщения
  • Статистика участников - активность, онлайн статус, детальный анализ
  • Красивые таблицы - вывод в консоли с цветным оформлением

📥 Экспорт данных

Для групп (4 формата):

  • TXT - простой список участников
  • CSV - таблица для Excel/Google Sheets
  • JSON - структурированные данные с полной статистикой
  • HTML - профессиональный отчёт с тёмной темой

Для личных чатов (5 форматов):

  • TXT - текстовая история
  • JSON - структурированные данные
  • CSV - таблица сообщений
  • XLSX - Excel с форматированием
  • HTML - красивая веб-страница как в Telegram

👥 Управление группой

  • Добавление участников - по username, ID или телефону (множественное)
  • Блокировка участников - kick, ban, просмотр забаненных
  • Управление правами - назначение админов, ограничения, должности

🎨 Интерфейс

  • Красивый ASCII баннер
  • Цветная консоль с Rich
  • Тёмная тема для HTML отчётов
  • Таблицы с рамками
  • Интуитивное меню

📦 Установка

Требования

Установка зависимостей

pip install telethon rich art openpyxl

🚀 Быстрый старт

1. Запуск

python TelegramRadar.py

2. Первая авторизация

При первом запуске программа попросит:

  • API_ID - ваш API ID с my.telegram.org
  • API_HASH - ваш API Hash
  • Номер телефона - в формате +79XXXXXXXXX
  • Код из Telegram - код подтверждения
  • 2FA пароль - если включена двухфакторная аутентификация

3. Автоматический вход

После успешной авторизации создаются файлы:

  • telegram_radar_session.session - сессия Telegram
  • telegram_radar_credentials.json - ваши API ключи

При следующем запуске вход произойдёт автоматически!


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

Главное меню

[1]  Мониторинг группы
[2]  Статистика группы
[3]  Статистика участников
[4]  Экспорт данных (txt/csv/json/html)
[5]  Добавить участников/бота
[6]  Блокировка участников
[7]  Управление правами
[8]  Настройки
[9]  Выход
[10] Личные чаты
[11] Отправить сообщение

Примеры использования

Экспорт группы в HTML

[4] Экспорт данных
→ Выбрать группу
→ [4] HTML (полная статистика)
→ Ждать анализа всех сообщений
→ Открыть файл в exports/

Что включено:

  • Аватар группы
  • 8 карточек со статистикой (участники, сообщения, медиа, фото, видео, ссылки, файлы)
  • Таблица администраторов
  • Полный список участников с ролями
  • Тёмная тема GitHub Dark

Экспорт личного чата

[10] Личные чаты
→ Выбрать чат
→ [1] Экспорт Чата
→ [5] HTML (полная история)
→ [5] ВСЯ ИСТОРИЯ
→ Готово!

Что включено:

  • Полная история переписки
  • Визуально как в Telegram (ваши сообщения справа, чужие слева)
  • Отметки о медиа файлах
  • Статистика переписки
  • Тёмная тема

Добавление участников

[5] Добавить участников
→ Выбрать группу
→ [1] По username
→ Ввести: user1, user2, user3
→ Подтвердить
→ Готово!

Блокировка спамеров

[6] Блокировка участников
→ Выбрать группу
→ [2] Забанить
→ [2] По ID
→ Ввести: 12345, 67890
→ Подтвердить
→ Готово!

Назначение админа

[7] Управление правами
→ Выбрать группу
→ [1] Назначить администратором
→ [1] По username → @newmod
→ Выбрать права
→ Должность: Модератор
→ Готово!

📊 Статистика и анализ

Анализ групп

Программа анализирует ВСЕ сообщения без ограничений и подсчитывает:

  • Общее количество сообщений
  • Медиа файлы (фото, видео, файлы)
  • Голосовые сообщения
  • Ссылки
  • Активность участников

Прогресс в реальном времени

При анализе больших групп показывается прогресс:

Анализ ВСЕХ сообщений группы...
Обработано 1000 сообщений...
Обработано 5000 сообщений...
...
✓ Проанализировано 123456 сообщений!

🎨 HTML Отчёты

Тёмная тема

Все HTML отчёты используют GitHub Dark цветовую схему:

  • Фон: #0d1117
  • Контейнеры: #161b22
  • Текст: #c9d1d9
  • Акцент: #667eea

Адаптивный дизайн

  • Работает на всех устройствах
  • Красивые градиенты и тени
  • Анимация при наведении
  • Современный UI/UX

📁 Структура файлов

telegram-radar/
├── test.py                              # Основной файл
├── telegram_radar_session.session       # Сессия Telegram
├── telegram_radar_credentials.json      # API ключи
└── exports/                             # Экспорты
    ├── group_20260203_120000.html       # Отчёт группы
    ├── avatar_20260203_120000.jpg       # Аватар группы
    ├── chat_20260203_120500.html        # История чата
    ├── monitor_20260203_121000.xlsx     # Мониторинг
    └── ...

⚡ Производительность

Операция Время
Анализ 1,000 сообщений ~5 сек
Анализ 10,000 сообщений ~40 сек
Анализ 100,000 сообщений ~6 мин
Экспорт группы (HTML) ~30 сек
Экспорт чата (1000 сообщений) ~15 сек
Добавление 10 участников ~30 сек

🛡️ Безопасность

Защита данных

  • API ключи хранятся локально
  • Сессия зашифрована Telethon
  • Никакие данные не отправляются третьим лицам

Защита от ошибок

  • Автоматическое ожидание при FloodWait
  • Обработка всех исключений
  • Валидация входных данных
  • Подтверждение опасных операций

🎯 Особенности

Мониторинг групп

  • Отслеживание сообщений в реальном времени
  • Автоматический экспорт в Excel
  • Логирование всех сообщений
  • Ctrl+C для остановки

Личные чаты

  • Просмотр списка чатов
  • Экспорт истории (5 форматов)
  • Блокировка собеседников
  • Отправка сообщений

Настройки

  • 9 цветовых тем
  • Обновление списка диалогов
  • Выбор активной группы
  • Информация о сессии

🔧 Настройка

Смена цветовой темы

[8] Настройки
→ [1] Смена темы программы
→ Выбрать цвет (1-9)

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

  • Cyan (по умолчанию)
  • Green
  • Magenta
  • Yellow
  • Red
  • Blue
  • Bright Cyan
  • Bright Green
  • White

Обновление списка диалогов

[8] Настройки
→ [2] Обновить диалоги

📝 Форматы экспорта

Группы

Формат Размер Содержимое
TXT ~5-20 KB Список участников, базовая статистика
CSV ~10-50 KB Таблица участников с данными
JSON ~20-100 KB Полная статистика, все данные
HTML ~50-200 KB Профессиональный отчёт с аватаром

Личные чаты

Формат Размер Содержимое
TXT ~10-100 KB Текстовая история
CSV ~20-200 KB Таблица сообщений
JSON ~30-300 KB Структурированные данные
XLSX ~50-500 KB Excel с форматированием
HTML ~100 KB-1 MB Веб-страница как в Telegram

🐛 Известные ограничения

  • Telegram API лимиты (FloodWait)
  • Нужны права админа для некоторых операций
  • Анализ очень больших групп (200k+ сообщений) может занять 10-15 минут

📞 Поддержка

При возникновении ошибок:

  1. Проверьте API ключи
  2. Убедитесь что у вас есть нужные права в группе
  3. Проверьте интернет соединение
  4. Обновите зависимости: pip install --upgrade telethon rich art openpyxl


👨‍💻 Автор

coder - @vksmitov


🌟 Возможности в разработке

  • Экспорт в PDF
  • Графики активности
  • Автоматические отчёты
  • Telegram Bot интеграция
  • Веб-интерфейс
  • AI Интилект для автомотизации
  • Скраппинг сообщений
  • Подключения API

Наслаждайтесь использованием Telegram Radar! 🚀

About

No description or website provided.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages