telegram_media_downloader

전보 미디어 다운로더

기능 요청 · 버그 신고 · 지원: 토론 및 텔레그램 커뮤니티

개요:

텔레그램에서 참여하고 있는 대화나 채널의 모든 미디어 파일을 다운로드하세요. 마지막으로 읽거나 다운로드한 메시지의 메타는 구성 파일에 저장되므로 동일한 미디어 파일을 다시 다운로드하지 않습니다.

지원하다:

범주	지원하다
언어	Python 3.7 이상
미디어 유형 다운로드	오디오, 문서, 사진, 비디오, video_note, 음성

할 일:

• 여러 채널/채팅에 대한 지원을 추가합니다.

설치

가용성을 make 한 *nix OS 배포판의 경우

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

make 내장되어 있지 않은 Windows의 경우

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

구성

모든 구성은 config.yaml 파일을 통해 Telegram Media Downloader로 전달됩니다.

API 키 얻기: 첫 번째 단계에서는 유효한 Telegram API 키(API ID/해시 쌍)를 얻어야 합니다.

1. https://my.telegram.org/apps를 방문하여 텔레그램 계정으로 로그인하세요.
2. 새로운 텔레그램 애플리케이션을 등록하려면 양식을 작성하세요.
3. 완료! API 키는 api_id 및 api_hash 의 두 부분으로 구성됩니다.

채팅 ID 가져오기:

1. 웹 텔레그램 사용:

1. https://web.telegram.org/?legacy=1#/im 열기
2. 이제 채팅/채널로 이동하면 다음과 같은 URL이 표시됩니다.
   • https://web.telegram.org/?legacy=1#/im?p=u853521067_2449618633394 여기서 853521067 이 채팅 ID입니다.
   • https://web.telegram.org/?legacy=1#/im?p=@somename 여기서 somename 채팅 ID입니다.
   • https://web.telegram.org/?legacy=1#/im?p=s1301254321_6925449697188775560 여기에서 1301254321 취하고 ID 시작 부분에 -100 추가합니다 => -1001301254321 .
   • https://web.telegram.org/?legacy=1#/im?p=c1301254321_6925449697188775560 여기에서 1301254321 취하고 ID 시작 부분에 -100 추가합니다 => -1001301254321 .

2. 봇 사용:

1. @username_to_id_bot을 사용하여 chat_id를 가져옵니다.
   • 거의 모든 텔레그램 사용자: 사용자 이름을 봇에 보내거나 메시지를 봇에 전달하세요.
   • 모든 채팅: 채팅 사용자 이름을 보내거나 JoinChat 링크를 복사하여 봇에 보냅니다.
   • 공개 또는 비공개 채널: 채팅과 동일하며 복사하여 봇으로 보내기만 하면 됩니다.
   • 텔레그램 봇의 ID

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
• api_id - 텔레그램 앱에서 얻은 api_id
• chat_id - 미디어를 다운로드하려는 채팅/채널의 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를 개방적이고 포괄적으로 유지하도록 도와주세요. 우리의 행동 강령을 읽고 따르십시오.