telegram_media_downloader

Загрузчик медиафайлов Telegram

Запрос на добавление · Сообщить об ошибке · Поддержка: обсуждения и сообщество Telegram

Обзор:

Загрузите все медиафайлы из беседы или канала, участником которого вы являетесь, из Telegram. Мета последнего прочитанного/загруженного сообщения сохраняется в файле конфигурации, поэтому он не будет повторно загружать тот же медиафайл.

Поддерживать:

Категория	Поддерживать
Язык	Python 3.7 и выше
Загрузить типы мультимедиа	аудио, документ, фото, видео, video_note, голос

Что сделать:

• Добавьте поддержку нескольких каналов/чатов.

Установка

Для дистрибутивов ОС *nix с возможностью make

$ git clone https://github.com/Dineshkarthik/telegram_media_downloader.git
$ cd telegram_media_downloader
$ make install

Для Windows, в которой нет встроенной make

$ git clone https://github.com/Dineshkarthik/telegram_media_downloader.git
$ cd telegram_media_downloader
$ pip3 install -r requirements.txt

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

Все конфигурации передаются в Telegram Media Downloader через файл config.yaml .

Получение ключей API. Самый первый шаг требует, чтобы вы получили действительный ключ API Telegram (пара идентификатор API/хэш):

1. Посетите https://my.telegram.org/apps и войдите в свою учетную запись Telegram.
2. Заполните форму для регистрации нового приложения Telegram.
3. Сделанный! Ключ API состоит из двух частей: api_id и api_hash .

Получение идентификатора чата:

1. С помощью веб-телеграммы:

1. Откройте https://web.telegram.org/?legacy=1#/im.
2. Теперь перейдите в чат/канал, и вы увидите URL-адрес примерно такого типа:
   • https://web.telegram.org/?legacy=1#/im?p=u853521067_2449618633394 здесь 853521067 — идентификатор чата.
   • https://web.telegram.org/?legacy=1#/im?p=@somename здесь somename — идентификатор чата.
   • https://web.telegram.org/?legacy=1#/im?p=s1301254321_6925449697188775560 здесь возьмите 1301254321 и добавьте -100 в начало идентификатора => -1001301254321 .
   • https://web.telegram.org/?legacy=1#/im?p=c1301254321_6925449697188775560 здесь возьмите 1301254321 и добавьте -100 в начало идентификатора => -1001301254321 .

2. Использование бота:

1. Используйте @username_to_id_bot, чтобы получить Chat_id
   • практически любой пользователь Telegram: отправьте боту имя пользователя или просто перешлите боту его сообщение
   • любой чат: отправьте имя пользователя чата или скопируйте и отправьте ссылку на его присоединение к боту.
   • общедоступный или частный канал: то же, что и чаты, просто скопируйте и отправьте боту
   • идентификатор любого телеграм-бота

config.yaml

 api_hash : your_api_hash
api_id : your_api_id
chat_id : telegram_chat_id
last_read_message_id : 0
ids_to_retry : []
media_types :
- audio
- document
- photo
- video
- voice
file_formats :
  audio :
  - all
  document :
  - pdf
  - epub
  video :
  - mp4

• api_hash — API_hash, полученный вами из приложений Telegram.
• api_id — API_id, полученный вами из приложений Telegram.
• chat_id — идентификатор чата/канала, из которого вы хотите загрузить медиафайлы. Что вы получите в результате вышеупомянутых шагов.
• Last_read_message_id — если вы собираетесь читать канал впервые, пусть это будет 0 , или, если вы уже использовали этот скрипт для загрузки мультимедиа, он будет иметь некоторые числа, которые автоматически обновляются после успешного выполнения скрипта. Не меняйте это.
• ids_to_retry — Leave it as it is. Это используется сценарием загрузчика для отслеживания всех пропущенных загрузок, чтобы их можно было загрузить во время следующего выполнения сценария.
• media_types — тип мультимедиа для загрузки. Вы можете указать, какой тип мультимедиа вы хотите загрузить. Это может быть один или любой из доступных типов.
• file_formats — типы файлов для загрузки для поддерживаемых типов мультимедиа: audio , document и video . Формат по умолчанию — all , загружаются все файлы.

Исполнение

$ python3 media_downloader.py

Все загруженные носители будут храниться в соответствующей директории, имя которой совпадает с тем же путем, что и скрипт Python.

Тип носителя	Скачать каталог
аудио	путь/к/проекту/аудио
документ	путь/к/проекту/документу
фото	путь/к/проекту/фото
видео	путь/к/проекту/видео
голос	путь/к/проекту/голосу
voice_note	путь/к/проекту/voice_note

Прокси

В настоящее время в этом проекте поддерживаются прокси socks4, socks5, http . Чтобы использовать его, добавьте следующее в конец файла config.yaml :

 proxy :
  scheme : socks5
  hostname : 11.22.33.44
  port : 1234
  username : your_username
  password : your_password

Если ваш прокси не требует авторизации, вы можете не указывать имя пользователя и пароль. После этого прокси будет автоматически включен.

Содействие

Рекомендации по участию

Прочтите наши рекомендации по участию, чтобы узнать о процессе подачи заявок, правилах кодирования и многом другом.

Хотите помочь?

Хотите сообщить об ошибке, добавить код или улучшить документацию? Отличный! Ознакомьтесь с нашими рекомендациями по внесению взносов.

Нормы поведения

Помогите нам сохранить Telegram Media Downloader открытым и инклюзивным. Пожалуйста, прочтите и соблюдайте наш Кодекс поведения.