https://github.com/psychowar/telegram-online-tracker
Скрипт для отслеживания онлайн-статуса указанного пользователя Telegram и ведения истории сессий. История сохраняется в online_sessions.json, а статистику можно просмотреть отдельным скриптом.
https://github.com/psychowar/telegram-online-tracker
monitoring online-status python telegram tracking
Last synced: about 1 month ago
JSON representation
Скрипт для отслеживания онлайн-статуса указанного пользователя Telegram и ведения истории сессий. История сохраняется в online_sessions.json, а статистику можно просмотреть отдельным скриптом.
- Host: GitHub
- URL: https://github.com/psychowar/telegram-online-tracker
- Owner: PsychoWAR
- Created: 2025-12-22T12:08:47.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-12-22T12:35:46.000Z (6 months ago)
- Last Synced: 2025-12-23T23:18:21.651Z (6 months ago)
- Topics: monitoring, online-status, python, telegram, tracking
- Language: Python
- Homepage:
- Size: 15.6 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Telegram-Online-Tracker
Скрипт для отслеживания онлайн-статуса указанного пользователя Telegram и ведения истории сессий. История сохраняется в `online_sessions.json`, а статистику можно просмотреть отдельным скриптом.
# ⚙️ Настройка
Создайте файл `.env`
Укажите в `.env` ваши данные:
``` text
Получите эти данные на 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 автоматически запросит код подтверждения при первом запуске.
- Если включён двухфакторный пароль, библиотека также запросит его в терминале.
# 🚀 Запуск трекера
``` bash
python telegram_online_tracker.py
```
или же через `run_tracker.bat`
# Что произойдет при первом запуске:
1. В Telegram придет код подтверждения — введите его в терминале.
2. Если установлен двухфакторный пароль, Telethon запросит и его.
3. После успешной авторизации скрипт начнёт отслеживать онлайн-статус указанного пользователя и вести лог.
# 📊 Просмотр статистики
Чтобы посмотреть историю и статистику сессий:
``` bash
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.