Skip to content

About

No description, website, or topics provided.

Resources

Stars

4 stars

Watchers

1 watching

Forks

Latest commit

 

History

18 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

TeleRipper

TeleRipper is an OSINT tool that allows investigators to download contents from any specified telegram channels

Pre-Requisites

  1. Telegram account
  2. Telegram API (Refer to Appendix: Telegram API for instructions to get the Telegram API for your account)

Installation

  1. Clone the repository

git clone https://github.com/RC-92/TeleRipper.git

  1. Navigate the cloned directory

cd TeleRipper

  1. Run installation Script

./setup.sh

  1. Activate Python Virtual Enviroment

source venv/bin/activate

Usage

  1. Initial run

python3 teleripper.py (On the first attempt of running the script you will be prompted to key in your account API key and API Hash, refer to Appendix: API Keys on the steps to retrieve them )

  1. Key in API ID:

image

  1. Key in API Hash

image

  1. Retrieve channel ID

image

  1. Download from channel

python3 TeleRipper-v3.py --d CHANNELID

image

  1. Download to specified Directory

python3 TeleRipper-v3.py --d CHANNELID -dir /path/to/dir

  1. Download specified type of media

python3 TeleRipper-v3.py --d CHANNELID -dir /path/to/dir -type TYPE

Currently available types

Videos

  • mp4
  • avi
  • mkv
  • mov
  • wmv
  • flv
  • webm
  • 3gp
  • m4v

Image

  • jpg
  • jpeg
  • png
  • gif
  • bmp
  • webp
  • svg
  • tiff

Document

  • pdf
  • doc
  • docx
  • xls
  • xlsx
  • ppt
  • pptx
  • txt
  • rtf
  • odt

Audio

  • mp3
  • wav
  • ogg
  • flac
  • m4a
  • aac
  • wma

Archive

  • zip
  • rar
  • 7z
  • tar
  • gz
  • bz2

Program

  • exe
  • apk
  • iso

Data

  • json
  • xml
  • csv
  • sql Web
  • html
  • css
  • js

Appendix: Get Account API credentials

  1. Navigate to https://my.telegram.org
  2. Select "API development account"

image

  1. Key App Name and App short name, leave the rest as it is and hit save changes

image

About

No description, website, or topics provided.

Resources

Stars

4 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages