semvec/pypi-packages huggingface dataset:
TelegramExplorer 0.3.0
Telegram Explorer
License: Apache-2.0
Requires Python: >=3.8.1,<4.0
Keywords: CyberSecurity,Investigation,OSINT,OpenSourceIntelligence,Tool

# Welcome to Telegram Explorer

[![](https://img.shields.io/github/last-commit/guibacellar/TEx)](https://github.com/guibacellar/TEx/tree/main)
[![](https://img.shields.io/github/languages/code-size/guibacellar/TEx)](https://github.com/guibacellar/TEx/tree/main)
[![](https://img.shields.io/badge/Python-3.8+-green.svg)](https://www.python.org/downloads/) 
[![](https://github.com/guibacellar/TEx/actions/workflows/cy.yml/badge.svg?branch=main)](https://github.com/guibacellar/TEx/actions/workflows/cy.yml)
[![](https://telegramexplorer.readthedocs.io/en/latest/?badge=latest)](https://telegramexplorer.readthedocs.io/en/latest/)
[![](https://img.shields.io/badge/maintainer-Th3%200bservator-blue)](https://theobservator.net/)
![](https://img.shields.io/github/v/release/guibacellar/TeX)

<!-- ABOUT THE PROJECT -->
## 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.

> ⚠️ **BETA VERSION** ⚠️
> <br/> Please note that V0.3.0 are the latest beta version for this project, so it is possible that you may encounter bugs that have not yet been mapped out.
> <br/> I kindly ask you to report the bugs at: [https://github.com/guibacellar/TEx/issues](https://github.com/guibacellar/TEx/issues)

<!-- REQUIREMENTS -->
## Requirements
- Python 3.8.1+ (⚠️ Deprecated. Consider using version 3.10+ ⚠️)
- Windows x64 or Linux x64

<!-- FEATURES -->
## Features
- Connection Manager (Handle Telegram Connection)
- Group Information Scrapper
- List Groups (Scrap info for all groups, including members, members info and profile pic)
- Automatic Group Information Sync
- Automatic Users Information Sync
- Messages Listener (Listen all Incoming Messages)
- Messages Scrapper (Scrap all Group Messages, since the first one)
- Download Media (Including fine media settings like size, groups and/or media type)
- HTML Report Generation
- Export Downloaded Files
- Export Messages
- Message Finder System (Allow to Find, using terms or RegEx) patterns on messages
- Message Notification System (Send alert's, finds, or all messages to Discord)
- Elastic Search 8+ Native Integration
- Image OCR using Tesseract
- Signals for Helping Monitoring


<!-- INSTALLING -->
## Installing
Telegram Explorer is available through *pip*, so, just use pip install in order to fully install TeX.

```bash
pip install TelegramExplorer
```

<!-- Upgrading -->
## Upgrading
To upgrade TeX to the latest version, just use *pip install upgrade* command.

```bash
pip install --upgrade TelegramExplorer
```

## Documentation
[https://telegramexplorer.readthedocs.io/en/latest/](https://telegramexplorer.readthedocs.io/en/latest/)