TelegramExplorer 0.2.2

Telegram Explorer

TEx - Telegram Explorer

Table of Contents

1. About The Project
2. Getting Started
   • Prerequisites
   • Installation
3. Available Modules
4. Usage
5. Command Line
6. Roadmap
7. Contributing
8. License
9. Contact

About The Project

TEx is a Telegram Explorer tool created to help Researchers, Investigators and Law Enforcement Agents to Collect and Process the Huge Amount of Data Generated from Criminal, Fraud, Security and Others Telegram Groups.

the available functionalities.

Getting Started

Prerequisites

• Python 3.8+

Installation

pip install TEx

Configuration

TEx need on at least, one configuration file. On reality, TEx need one configuration file for each phone number you want to use.

[CONFIGURATION]
api_id=my_api_id
api_hash=my_api_hash
phone_number=my_phone_number
data_path=my_data_path

• api_id > Required - Telegram API ID. From https://my.telegram.org/ > login > API development tools
• api_hash > Required - Telegram API Hash. From https://my.telegram.org/ > login > API development tools
• phone_number > Required - Target Phone Number
• data_path > Optional - Defines the Path Folder for the SQLite Databases and Dowloaded Files

Usage

Basic TEx Usage.

Considering a my_TEx_config.config file created at /usr/my_TEx_config.config with follow:

[CONFIGURATION]
api_id=12345678
api_hash=dff159855418ddfaddf10dcbdeadbeef
phone_number=5511987542563
data_path=/usr/TEx/

Execute the first 2 commands to configure and sync TEx and the last one to activate the listener module.

TEx connect --config /usr/my_TEx_config.config
TEx load_groups --config /usr/my_TEx_config.config
TEx listen --config /usr/my_TEx_config.config

Command Line

Connect to Telegram Servers

TEx connect --config CONFIGURATION_FILE_PATH

• config > Required - Created Configuration File Path

Update Groups List (Optional, but Recommended)

TEx load_groups --config CONFIGURATION_FILE_PATH --refresh_profile_photos

• config > Required - Created Configuration File Path
• refresh_profile_photos > Optional - If present, forces the Download and Update all Channels Members Profile Photo

List Groups

TEx list_groups --config CONFIGURATION_FILE_PATH 

• config > Required - Created Configuration File Path

Listen Messages (Start the Message Listener)

TEx listen --config CONFIGURATION_FILE_PATH --group_id 1234,5678

• config > Required - Created Configuration File Path
• ignore_media > Optional - If present, don't Download any Media
• group_id > Optional - If present, Download the Messages only from Specified Groups ID's

Download Messages (Download since first message for each group)

TEx download_messages --config CONFIGURATION_FILE_PATH --group_id 1234,5678

• config > Required - Created Configuration File Path
• ignore_media > Optional - If present, don't Download any Media
• group_id > Optional - If present, Download the Messages only from Specified Groups ID's

Generate Report

TEx report --config CONFIGURATION_FILE_PATH --report_folder REPORT_FOLDER_PATH --group_id * --around_messages NUM --order_desc --limit_days 3 --filter FILTER_EXPRESSION_1,FILTER_EXPRESSION_2,FILTER_EXPRESSION_N

• config > Required - Created Configuration File Path
• report_folder > Optional - Defines the Report Files Folder
• group_id > Optional - If present, Download the Messages only from Specified Groups ID's
• around_messages > Optional - Number of messages around (Before and After) the Filtered Message
• order_desc > Optional - If present, sort all messages descending. Otherwise, sort Ascending.
• limit_days > Optional - Number of Days of past to filter the Messages
• filter > Optional - Simple (Comma Separated) String Terms Filter. Ex: hacking,"Car Hacking",foo
• suppress_repeating_messages > Optional - If present, suppress all repeating messages in the same report

Export Downloaded Files

TEx export_file --config CONFIGURATION_FILE_PATH -report_folder REPORT_FOLDER_PATH --group_id * --filter * --limit_days 3 --mime_type text/plain

• config > Required - Created Configuration File Path
• report_folder > Optional - Defines the Report Files Folder
• group_id > Optional - If present, Download the Messages only from Specified Groups ID's
• filter > Optional - Simple (Comma Separated) FileName String Terms Filter. Ex: malware, "Bot net"
• limit_days > Optional - Number of Days of past to filter the Messages
• mime_type > Optional - File MIME Type. Ex: application/vnd.android.package-archive

License

Distributed under the Apache License. See LICENSE for more information.

Contact

Th3 0bservator