Telegram Explorer
Project description
TEx - Telegram Explorer
Table of Contents
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.1+
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=5511987654321
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
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for telegramexplorer-0.2.5-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ea8b4df60373539fb37957143d190b9f7b7d3c9f0bcba796d7340fb6a2c479a2 |
|
MD5 | 661f81f0add5736ec6a824f0538a6a46 |
|
BLAKE2b-256 | 6dd4ad852a2304bec5f35a7b697d17cdfaaff3655c9c04878f627b3c744f8b6a |