Telegram-Online-Tracker

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

⚙️ Настройка

Создайте файл .env

Укажите в .env ваши данные:

Получите эти данные на https://my.telegram.org
API_ID=
API_HASH=

Ваш номер телефона в формате +79991234567
PHONE_NUMBER=

Username пользователя, за которым следим (без @)
TARGET_USERNAME=

Примечание:

• API_ID и API_HASH — обязательны.
• PHONE_NUMBER должен быть в международном формате.
• TARGET_USERNAME — Telegram username без @.
• Telethon автоматически запросит код подтверждения при первом запуске.
• Если включён двухфакторный пароль, библиотека также запросит его в терминале.

🚀 Запуск трекера

python telegram_online_tracker.py

или же через run_tracker.bat

Что произойдет при первом запуске:

1. В Telegram придет код подтверждения — введите его в терминале.
2. Если установлен двухфакторный пароль, Telethon запросит и его.
3. После успешной авторизации скрипт начнёт отслеживать онлайн-статус указанного пользователя и вести лог.

📊 Просмотр статистики

Чтобы посмотреть историю и статистику сессий:

python view_stats.py

или же run_view_stats.bat

Скрипт выведет:

• Время входа и выхода пользователя
• Длительность каждой сессии
• Общее время онлайн
• Статистику по дням недели

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

Все данные сохраняются в online_sessions.json.
Логи и статистика обновляются автоматически.
Скрипт работает в консоли, GUI не требуется.
Можно запускать несколько раз — данные добавляются в тот же файл.

📦 Требования

• Python 3.11+
• Библиотеки:
  pip install telethon python-dotenv

🔒 Советы по безопасности и приватности

1. Не выкладывайте .env в открытый доступ.
2. Используйте отдельный аккаунт Telegram для трекера.
3. Не используйте слишком короткие интервалы проверки (15–30 секунд безопасно).
4. Файл online_sessions.json содержит всю историю — не публикуйте его открыто.
5. Если трекер запускается на чужом ПК, убедитесь, что никто не сможет открыть .env или JSON-файл.
6. Периодически делайте бэкап online_sessions.json.