TeleRipper is an OSINT tool that allows investigators to download contents from any specified telegram channels
- Telegram account
- Telegram API (Refer to Appendix: Telegram API for instructions to get the Telegram API for your account)
- Clone the repository
git clone https://github.com/RC-92/TeleRipper.git
- Navigate the cloned directory
cd TeleRipper
- Run installation Script
./setup.sh
- Activate Python Virtual Enviroment
source venv/bin/activate
- 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 )
- Key in API ID:
- Key in API Hash
- Retrieve channel ID
- Download from channel
python3 TeleRipper-v3.py --d CHANNELID
- Download to specified Directory
python3 TeleRipper-v3.py --d CHANNELID -dir /path/to/dir
- Download specified type of media
python3 TeleRipper-v3.py --d CHANNELID -dir /path/to/dir -type TYPE
Videos
- mp4
- avi
- mkv
- mov
- wmv
- flv
- webm
- 3gp
- m4v
Image
- jpg
- jpeg
- png
- gif
- bmp
- webp
- svg
- tiff
Document
- 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
- Navigate to https://my.telegram.org
- Select "API development account"
- Key App Name and App short name, leave the rest as it is and hit save changes





