✞ Sessions Checker

Версия: 4.0.0b
Поддерживаемые ОС: Windows / Linux / MacOS / Android

---

Описание

Sessions Checker — консольный инструмент для автоматической проверки и управления Telegram .session файлами.
Инструмент сканирует .session файлы, определяет их статус (valid, invalid, bot, active, flood, timeout, errors), перемещает файлы в соответствующие папки, создаёт отчёты и бэкапы, поддерживает интерактивное управление аккаунтами и получение кода от служб Telegram. Взаимодействие с API реализовано через библиотеку Telethon, работающую с Telegram.

---

Возможности

• Массовая проверка .session файлов.
• Классификация: valid, invalid, bot, is_active, flood, timeout, errors.
• Перемещение/копирование сессий в отдельные папки.
• Создание JSON-отчётов: check_YYYY-MM-DD_HH-MM-SS.json.
• Создание бэкапов: backup_sessions_YYYY-MM-DD_HH-MM-SS/.
• Регистрация новых аккаунтов (через ввод номера и кода).
• Подключение к существующим сессиям, просмотр переписок и получение кодов от 777000.
• Поддержка работы на Android (Termux), Windows, Linux, macOS.

---

Требования

• Python >= 3.10
• Рекомендуется виртуальное окружение.

Файл зависимостей: requirements.txt.

---

Установка (быстро)

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

git clone https://github.com/Georgiy00987/Sessions-Checker.git
cd sessions-checker

2. Создайте и активируйте виртуальное окружение:

python -m venv venv
# Windows
venv\Scripts\activate
# Linux/macOS/Termux
source venv/bin/activate

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

pip install -r requirements.txt

---

Конфигурация

Создайте config.json в корне репозитория (пример):

{
	"apps": [
		{
			"api_id": 123456,
			"api_hash": "0123456789abcdef0123456789abcdef"
		}
	],
	"semaphore": 10
}

• apps — список приложений (можно несколько); скрипт пробует их по очереди.
• semaphore — число одновременных подключений (необязательно). Если не указан — определяется автоматически.

ВАЖНО: НЕ публикуйте реальные api_id, api_hash и файлы .session в публичных репозиториях.

---

Запуск

python main.py

После запуска появится интерактивное меню:

• 1 — Проверить сессии
• 2 — Управление файлами сессий (удалить мусор, создать отчёт, бэкап)
• 3 — Управление аккаунтами (создать / подключиться)
• 4 — Информация (статистика)
• 5 — Выйти

---

Как программа ищет .session файлы

• Текущая директория.
• Сканирование устройства (Windows: все диски; Android: /sdcard/; Unix: домашняя папка).
• Указанная вручную директория.

Минимальный размер файла для проверки: 100 B.

---

Куда перемещаются результаты

Папка результата: forget_git/ (создаётся автоматически). Подпапки:

• forget_git/valid — валидные сессии
• forget_git/invalid — невалидные
• forget_git/bot — боты
• forget_git/is_active — занятые / конфликтующие ключи
• forget_git/flood — FloodWait
• forget_git/timeout — таймауты
• forget_git/errors — ошибки при проверке

---

Примеры вывода (консоль)

 ├ [+] session1.session is Valid! Name: John Doe. ID: 123456789. Phone: +123456789
 ├ [?] session2.session is Bot. Name: BotUser. ID: 987654321
 ├ [-] session3.session is Invalid.

---

Создание отчётов и бэкапов

• Отчёт: создаётся check_YYYY-MM-DD_HH-MM-SS.json с суммарной статистикой.
• Бэкап: копирование рабочих сессий (valid и flood) в папку backup_sessions_YYYY-MM-DD_HH-MM-SS/.

---

Файлы репозитория (рекомендуемая структура)

sessions-checker/
├─ main.py
├─ config.json.example
├─ README.md
├─ requirements.txt
├─ LICENSE
├─ .gitignore
└─ forget_git/
   ├─ valid/
   ├─ invalid/
   ├─ bot/
   ├─ is_active/
   ├─ flood/
   ├─ timeout/
   └─ errors/

---

Лицензия

MIT License

---

Контакты

Автор: @forget_git (Telegram)