vovan/telethon-cli repository overview

docker-compose.yml

services:
  telethon-cli:
    build: .
    image: vovan/telethon-cli
    container_name: telethon-cli
    env_file: .env
    volumes:
      - ./data:/app/data

.env

API_ID=
API_HASH=

ls ./data

session_id.session

⁠Переменные окружения

• API_ID - ID приложения с my.telegram.org
• API_HASH - Hash приложения с my.telegram.org

⁠Команды

⁠channels

Список каналов/чатов, к которым привязан аккаунт.

telethon-cli channels

Ответ в JSON: {"channels": [{"id", "title", "channel_username", ...}]}.

⁠messages

Получение сообщений из диалога.

По дате:

telethon-cli messages --dialog-id <ID> --date 2025-01-15 [--limit 1000]

• --limit — сколько сообщений просматривать (по умолчанию 1000, макс. 20000).

По лимиту символов:

telethon-cli messages --dialog-id <ID> --chars-limit 50000

• --chars-limit — суммарный объём текста в символах (по умолчанию 20000, макс. 100000).

--dialog-id можно взять из вывода channels (поле id).

Первый запуск может потребовать интерактивной авторизации (логин/код из Telegram); том /app/data нужен для хранения сессии. Внимание: наличие файла сессии дает полный доступ к вашему телеграм-аккаунту.

⁠Отладка

telethon-cli --debug channels