Sleuth: Powerful telegram message extractor

Telegram Sleuth is a powerful tool designed for extracting and analyzing data from Telegram chats. this tool allows you to efficiently extract messages, media, and metadata for thorough analysis.

The extracted data can be organized chronologically by user, and media files can be downloaded into designated folders for offline access. Additionally, the parsed data can be exported into a structured CSV file, facilitating further processing and integration with other tools.

Features

• Extract messages, media, and metadata from Telegram chats.

• Organize messages chronologically by user for easy analysis.

• Download shared media files (images, videos, audio, documents) into designated folders for offline access.

• Export parsed data into a structured CSV file for further processing and integration with other tools.

Where to get it

The source code is hosted on GitHub at: https://github.com/naufalmng/telegram-sleuth

Install with PyPI

  pip install telegram-sleuth

Usage

from telegram_sleuth import Sleuth

# Authenticate with your Telegram API credentials
sleuth = Sleuth(
    api_id='YOUR_API_ID', #11513413
    api_hash='YOUR_API_HASH', #843c16a33c3c4e75f36ea546123ec2d
    username='TARGET_USERNAME',
    start_date='2023-11-20',  # Optional: Specify a start date for data extraction
    end_date='2023-11-21',    # Optional: Specify an end date for data extraction
    download_path=r'C:\Path\to\Downloads\Folder',  # Optional: Set a custom download path
    print_to_console=True  # Optional: Print messages to the console as they are extracted
)

# Extract messages and media
data = sleuth.dig()

# Export extracted data to a CSV file
sleuth.export_to_csv('chat_data.csv')

Functions

• Sleuth(api_id, api_hash, username):

  Purpose: Initializes the Sleuth object for interacting with Telegram.

  Parameters	⠀
  api_id	Your Telegram API ID (required). you can get it on https://my.telegram.org/apps.
  api_hash	Your Telegram API hash (required). same source as api_id.
  username	The telegram username target (required). regularly it's on the group/contact info.

  Optional Parameters	⠀
  start_date	A string in the format 'YYYY-MM-DD' to specify a start date for data extraction (default: None).
  end_date	A string in the format 'YYYY-MM-DD' to specify an end date for data extraction (default: None).
  download_path	A path to a directory where downloaded media will be saved (default: None).
  print_to_console	A boolean indicating whether to print messages to the console as they are extracted (default: False).

• dig():

  Purpose: Extracts messages, media, and metadata from the specified chat.

  Returns: A python dictionary containing the extracted information.

• export_to_csv(file_path):

  Purpose: Exports the extracted data to a CSV file.

  Parameter:	⠀
  file_path	The path to the CSV file where the data will be saved.

License

GNU GPLv3

Support

For support, email [email protected] or create an issue on github page, https://github.com/naufalmng/telegram-sleuth/issues.