TG Manager

Много Telegram-аккаунтов на одном Windows. Каждый - в своём контейнере, со своим прокси.

Один контейнер - одна папка tdata, своё имя, свой HTTP/SOCKS5-прокси. Запуск многих окон Telegram Desktop одновременно, живой статус, честная остановка процесса. Чистка аккаунта (каналы, группы, личка, боты, контакты, фото) - через Telethon прямо из tdata, без ввода номера и кода.

Портативно: распаковали zip - работает. Ничего не пишется в %APPDATA%, папку можно перенести на другой диск или ПК целиком.

Скачать

Установка одной командой

В PowerShell (Windows 10/11, админ не нужен):

irm https://raw.githubusercontent.com/scarrymany/tg-manager/main/install.ps1 | iex

То же самое: iwr https://raw.githubusercontent.com/scarrymany/tg-manager/main/install.ps1 | iex

Скрипт берёт latest GitHub Release (TG-Manager-x.y.z.zip, не prerelease) и ставит на рабочий стол:

Desktop\TG-Manager\TGManager.exe (+ TGWorker.exe). OneDrive Desktop подхватывается сам.

Если папка уже есть - обновляет файлы из zip на месте. config.json и accounts\ не трогает (также telegram\, tools\).

Ярлык TG Manager на рабочем столе создаётся по умолчанию.

Сохранённый скрипт:

powershell -ExecutionPolicy Bypass -File install.ps1
powershell -ExecutionPolicy Bypass -File install.ps1 -InstallDir "D:\Apps\TG-Manager" -Force -NoShortcut

Ключ	Что делает
-InstallDir	Папка установки (по умолчанию <Desktop>\TG-Manager)
-Force	Закрыть занятые TGManager.exe/TGWorker.exe из этой папки и перезаписать exe. Данные не трёт
-NoShortcut	Не создавать ярлык TG Manager.lnk
-LocalZip	Готовый TG-Manager-*.zip, без GitHub (офлайн)

Для one-liner те же опции через env: TGMANAGER_INSTALL_DIR, TGMANAGER_FORCE=1, TGMANAGER_NO_SHORTCUT=1, TGMANAGER_LOCAL_ZIP.

Вручную

⬇ TG-Manager-1.4.0.zip · Windows 10 (1809+) / 11, x64

1. Распакуйте в любую папку.
2. Запустите TGManager.exe (TGWorker.exe должен лежать рядом).
3. Добавить контейнер → Папка → положите туда tdata → Запуск.

Официальный портативный Telegram Desktop программа скачает сама при первом запуске (~50 МБ).

Новое в 1.4.0

Полный интерфейс по актуальному дизайну SCARP.CC: боковая навигация, шрифт Inter, монохромная палитра, белые кнопки и компактные карточки. Все формы и диалоги используют общие контролы. Поиск по имени, ID, заметкам и прокси, фильтры состояния, сортировка и отдельные показатели контейнеров.

Папки для разных задач

1. Нажмите + Папка в боковой панели и задайте имя группы.
2. Откройте Изменить у контейнера и укажите папку. Там же можно создать новую папку вводом имени.
3. Выберите группу в разделе Папки контейнеров боковой панели. Поиск и фильтр состояния применяются внутри неё.
4. Переименовать обновляет название для всех контейнеров группы. Удалить папку сохраняет контейнеры в Без папки.

Пустые папки сохраняются после перезапуска. Это группы в интерфейсе: физические пути tdata не меняются. Заметки отображаются на карточках и участвуют в поиске. Ctrl+F переводит фокус в поиск, Escape в поле поиска сбрасывает запрос и фильтры.

Скриншоты ниже показывают интерфейс на тестовых контейнерах.

Возможности

• Контейнеры. Карточка = аккаунт: имя, цвет, папка, tdata. Сколько угодно.
• Параллельный запуск. Telegram.exe -workdir <контейнер> -many -noupdate, живой статус каждые 2 секунды.
• Стоп - это стоп. Процесс завершается (TerminateProcess + taskkill /T), а не прячется в трей.
• Прокси на контейнер. SOCKS5 напрямую, HTTP через встроенный мост. Логин и пароль поддерживаются. Строку вида socks5://user:pass@host:port или host:port:user:pass можно просто вставить.
• Чистка аккаунта. Каналы, группы, личные чаты, боты (с блокировкой), «Избранное», контакты, фото профиля. Dry-run перед необратимым. FloodWait ждётся автоматически. Журнал в UTF-8.
• Експорт session. Кнопка на карточке → папка → {phone}.session (Telethon SQLite из tdata) + {phone}.json (SCARP_CC) + {phone}.zip. Telegram контейнера должен быть закрыт.
• Защита сессии. Пока идёт чистка или експорт, запуск Telegram этого контейнера заблокирован - никаких AUTH_KEY_DUPLICATED.
• Нативный интерфейс. WPF, тёмная тема, скруглённое окно, плавные анимации, PerMonitorV2 DPI.

Как это выглядит

Активные задачи - чистка идёт в фоне, прогресс и журнал по каждому контейнеру.	Автоматизация - выбираете разделы, проверяете dry-run, подтверждаете.
Контейнер - имя, цвет, прокси одной строкой.	Настройки - портативный Telegram, прокси-обёртка, ярлык на рабочий стол.

Как устроено

TG-Manager\
  TGManager.exe          запуск (WPF, .NET 9, self-contained)
  TGWorker.exe           чистка tdata (Telethon + opentele-ng), без окна
  config.json            контейнеры и настройки
  accounts\<id>\tdata\   сюда кладёте tdata
  telegram\Telegram.exe  портативный Telegram (скачивается кнопкой)
  tools\proxychains\     прокси-обёртка (скачивается кнопкой, ~200 КБ)

Что	Как
Запуск	Telegram.exe -workdir accounts\<id> -many -noupdate
SOCKS5	Windows-порт ProxyChains оборачивает процесс Telegram
HTTP	локальный SOCKS5-мост внутри TGManager.exe → HTTP CONNECT → ваш прокси
Чистка / експорт	TGWorker.exe читает tdata через opentele; експорт пишет Telethon {phone}.session + JSON + zip
Стоп	дерево процессов контейнера завершается принудительно, pid-файл и мост очищаются

Сборка из исходников

Нужны .NET 9 SDK и Python 3.12.

git clone https://github.com/scarrymany/tg-manager.git
cd tg-manager
build.bat

Результат - dist\TG-Manager\ с TGManager.exe и TGWorker.exe. Для разработки: dotnet run --project src\TGManager\TGManager.csproj; воркер подхватится как python -m tgmanager.automation.worker, если рядом нет TGWorker.exe (pip install -r requirements-worker.txt).

Структура: src/TGManager - WPF-приложение, tgmanager/automation - Python-воркер чистки и експорта, worker.spec + worker_entry.py - сборка TGWorker.exe, assets/ - иконки.

CI (GitHub Actions, windows-latest) собирает zip и публикует релиз v<версия> при каждом пуше в main; версия берётся из TGManager.csproj.

Требования

• Windows 10 x64 (1809+) или Windows 11 x64.
• Ничего ставить не нужно: .NET и Python внутри exe.

Если что-то не так

Симптом	Что делать
«Не найден Telegram»	Настройки → Скачать переносной Telegram
Прокси не применился	Настройки → Скачать прокси-обёртку
Аккаунт не запускается	В папке контейнера должна быть именно tdata, а не tdata\tdata
Чистка не стартует	TGWorker.exe должен лежать рядом с TGManager.exe из того же zip
Telegram не остановился	Закройте его из трея (Quit Telegram) - это редкий случай зависшего процесса
Что-то упало	Рядом с программой появится error.log - приложите его к issue

Автор

Разработчик - @yeet17 в Telegram · scarrymany на GitHub. Кнопки GitHub и Telegram есть прямо в заголовке программы.

История изменений - в CHANGELOG.md. Лицензия - MIT.

Старая Linux-версия (PyQt) сохранена в релизе linux-legacy и не поддерживается.