🖤 Tele Tool!

---

♥️ О проекте

Tele Tool — Инструмент для работы с Telegram сессиями. Программа предоставляет полный набор функций для управления и конвертации Telegram аккаунтов, делая процесс максимально простым и эффективным.

---

🖤 Основные возможности:

📂 КАТЕГОРИЯ: 💫 Операции с сессиями

└─ 💨 Анализ сессии

• 1. Настройка device (Предлагает на выбор конфигурации девайсов для входа в сессию от их лица)
• 2. Настройка API id and hash (Настройка данных для подключения к Telegram API)
• 3. Открытие директории для загрузки данных (Папка для .session файлов)
• 4. Открытие директории для получения результатов (Папка с результатами анализа)
• 5. Анализ аккаунта (Получение полной информации о сессии в JSON формате)

└─ 💨 Создать session через QR

• 1. Настройка device (Предлагает на выбор конфигурации девайсов для входа в сессию от их лица)
• 2. Настройка API id and hash (Настройка данных для подключения к Telegram API)
• 3. Получить QR код (Папка для .session файлов)
• 4. Открытие директории для получения результатов (Папка с результатами анализа)

└─ 💨 Создать session через код

• 1. Настройка device (Предлагает на выбор конфигурации девайсов для входа в сессию от их лица)
• 2. Настройка API id and hash (Настройка данных для подключения к Telegram API)
• 3. Получить QR код (Папка для .session файлов)
• 4. Открытие директории для получения результатов (Папка с результатами анализа)

📂 КАТЕГОРИЯ: 🔄 Конвертация

└─ 💨 Session ➜ Tdata

• 1. Настройка device (Предлагает на выбор конфигурации девайсов для входа в сессию от их лица)
• 2. Настройка API id and hash (Настройка данных для подключения к Telegram API)
• 3. Открытие директории для загрузки .session файлов
• 4. Открытие директории с результатами конвертации
• 5. Конвертация .session файлов в формат Telegram Desktop (tdata)

└─ 💨 Tdata ➜ Session

• 1. Настройка device (Предлагает на выбор конфигурации девайсов для входа в сессию от их лица)
• 2. Настройка API id and hash (Настройка данных для подключения к Telegram API)
• 3. Открытие директории для загрузки tdata папок
• 4. Открытие директории с результатами конвертации
• 5. Конвертация Telegram Desktop (tdata) файлов в формат .session

└─ 💨 Session ➜ Info

• 1. Открытие директории для загрузки .session файла
• 2. Открытие директории с результатами конвертации
• 3. Анализ файла .session и получение информации в формате JSON

📂 КАТЕГОРИЯ: 🧹 Управление и очистка

└─ 💨 Очистка каналов | групп | ботов | чатов

• 1. Настройка device (Предлагает на выбор конфигурации девайсов для входа в сессию от их лица)
• 2. Настройка API id and hash (Настройка данных для подключения к Telegram API)
• 3. Открытие директории для загрузки .session файла
• 4. Вывести кол-во диалогов (каналы, группы, боты, чаты)
• 5. Выйти со всех диалогов (каналы, группы, боты, чаты)

---

⚙️ Используемые технологии

🛠️ Основные библиотеки

---

📋 Требования

💻 Системные требования:

• Python 3.8 или выше (желательно 3.11.6)
• Windows операционная система
• Минимум 100MB свободного места
• Стабильное подключение к интернету
• RAM: минимум 2GB

🔑 Telegram API:

• API ID (получить на my.telegram.org)
• API Hash (получить на my.telegram.org)
• Активный Telegram аккаунт
• Доступ к Telegram API

---

🌳 Структура проекта

Telegram-Toolkit/
├── 📁 menu/               # Модули меню
│   ├── banner.py         # Отрисовка баннера и разделителей
│   ├── session_analyzer.py       # Меню анализа сессий
│   ├── session_creator_qr.py      # Создание сессий через QR
│   ├── session_creator_code.py   # Авторизация по коду
│   └── cleaner_and_info.py       # Управление очисткой аккаунта
│
├── 📁 utils/             # Вспомогательные модули
│   ├── get_account_info.py      # Парсинг информации об аккаунте
│   ├── create_session_qrcode.py # Генерация QR-кодов
│   ├── convert_session_tdata.py # Конвертация session → tdata 
│   ├── convert_tadata_session.py # Конвертация tdata → session
│   └── clener_dialogs.py        # Логика очистки диалогов
│
├── 📁 src/               # Ресурсы проекта
│   └── set_apps.json     # База устройств для эмуляции
│
├── 📁 results/            # Результаты работы
│   ├── account_info_save/ # Дампы информации аккаунтов
│   ├── session_analyzer/  # Результаты анализа сессий
│   └── create_session_*/  # Созданные session-файлы
│
├── 📄 main.py            # Главный исполняемый файл
├── 📄 config.ini         # Конфигурация API и устройств
├── 📄 requirements.txt   # Зависимости проекта
└── 📄 run.bat            # Скрипт запуска для Windows

Пояснения к структуре:

1. Ядро системы (main.py) - Центральный модуль, управляющий всей логикой приложения
2. Меню-модули - Группа файлов реализующих интерактивный интерфейс
3. Утилиты - Набор "движков" для выполнения основных операций
4. Конфигурация - Файлы настроек и пресетов устройств
5. Результаты - Автоматически генерируемые в процессе работы данные

---

🚀 Руководство по запуску

1. Клонирование репозитория

git clone https://github.com/klintxxxgod/TeleTool
cd TeleTool

2. Настройка окружения

# Создание виртуального окружения (Windows)
python -m venv venv
venv\Scripts\activate

# Установка зависимостей
pip install -r requirements.txt

3. Настройка конфигурации

1. Получите API ID и Hash на my.telegram.org
2. Отредактируйте config.ini:

[QR]
device_id = 0
api_id = YOUR_API_ID       # Замените на свои значения
api_hash = YOUR_API_HASH   # 32-символьная строка

4. Запуск приложения

# Стандартный запуск
python main.py

# Или через bat-файл (Windows)
run.bat

🛠 Первый запуск:

1. При открытии любого меню где требуется Telegram API приступайте к пункту 2 и 3
2. Настройте device (рекомендуется выбор 0 - Xiaomi)
3. Введите валидные API данные
4. Следуйте инструкциям на экране

⚠️ Важно!

• Используйте только свои API ключи
• Не делитесь файлами .session и tdata
• При ошибках проверьте логи в results/*/*.log

🖤 Контакты