tdl (Telegram Downloader)
tdl — это мощный инструмент командной строки и библиотека на языке Go для скачивания и управления данными в Telegram.
Сайт: docs.iyear.me/tdl GitHub: iyear/tdl
Особенности
- Скорость: Написан на Go, использует MTProto и многопоточность для максимальной скорости загрузки.
- Эффективность: Потребляет мало ресурсов, работает быстрее официальных клиентов.
- Обход ограничений: Умеет качать из каналов с запретом пересылки (protected content).
- Экспорт: Поддерживает экспорт сообщений и медиа в JSON.
Установка
Автоматический скрипт (Linux/macOS)
curl -sSL https://docs.iyear.me/tdl/install.sh | sudo bash
Homebrew (macOS)
brew install telegram-downloader
Windows
Для Windows доступен установочный скрипт через PowerShell или пакетный менеджер Scoop.
scoop bucket add extras
scoop install telegram-downloader
Использование
Перед началом работы нужно авторизоваться. tdl использует концепцию "пространств имен" (namespaces) для хранения сессий разных аккаунтов.
Авторизация
Самый простой способ — войти через Desktop клиент (если он установлен и запущен на том же устройстве), либо через QR-код/номер телефона.
# Интерактивный вход (потребуется ввести номер и код)
tdl login -n my_account
Скачивание фай лов
Основная команда для скачивания — dl. Требует ссылку на сообщение или пост.
# Скачать одно вложение
tdl dl -n my_account -u https://t.me/durov/123
# Скачать диапазон (если поддерживается конкретной версией и синтаксисом)
# Обычно tdl ориентирован на список ссылок или выгрузку чата
Для массовой выгрузки часто используют экспорт чата или JSON-списки.
Экспорт чата (Backup)
tdl умеет делать бекап чатов (сообщения + медиа).
tdl chat export -n my_account -c durov --output json
Сравнение с tgarc
| Характеристика | tdl | tgarc (Ruarxive) |
|---|---|---|
| Язык | Go (компилируемый) | Python (скриптовый) |
| Скорость | Очень высокая | Средняя/Высокая |
| Сложность | Требует настройки MTProto | Проще в установке (pip) |
| Основная цель | Быстрая загрузка файлов | Архивация и метаданные |
Мы рекомендуем использовать tdl для загрузки очень больших объемов файлов (видео, архивы), где критична скорость. Для структурированной архивации контента с сохранением контекста лучше подходит tgarc.