Metadata-Version: 2.1
Name: TelegramExplorer
Version: 0.2.15
Summary: Telegram Explorer
Home-page: https://github.com/guibacellar/TEx
License: Apache-2.0
Keywords: CyberSecurity,Investigation,OSINT,OpenSourceIntelligence,Tool
Author: Th3 0bservator
Author-email: th30bservator@gmail.com
Maintainer: Th3 0bservator
Maintainer-email: th30bservator@gmail.com
Requires-Python: >=3.8.1,<4.0
Classifier: Environment :: Console
Classifier: Intended Audience :: Information Technology
Classifier: License :: Freely Distributable
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Security
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Requires-Dist: Jinja2 (>=3.0.3)
Requires-Dist: SQLAlchemy (>=2.0.19,<2.1)
Requires-Dist: Telethon (==1.29.2)
Requires-Dist: aiosqlite (>=0.19.0)
Requires-Dist: build (>=0.10.0,<0.11.0)
Requires-Dist: cachetools (>=5.3.1,<6)
Requires-Dist: cryptg (>=0.2.post4)
Requires-Dist: discord-webhook (>=1.3.0,<2)
Requires-Dist: poetry-core (>=1.6.1,<2)
Requires-Dist: poetry-plugin-export (>=1.4.0,<2.0.0)
Requires-Dist: pytz (>=2023.3)
Requires-Dist: requests (>=2.31.0,<3)
Requires-Dist: telethon-cryptg (>=0.0.4)
Requires-Dist: toml (>=0.10.2)
Requires-Dist: tox (>=4.10.0,<5.0.0)
Requires-Dist: urllib3 (>=1.26.8)
Project-URL: Documentation, https://telegramexplorer.readthedocs.io/en/latest/
Project-URL: Repository, https://github.com/guibacellar/TEx
Description-Content-Type: text/markdown

# 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 this project has been in beta for a few weeks, 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
- Group Information Scrapper
- List Groups
- Automatic Group Information Sync
- Automatic Users Information Sync
- Messages Listener
- Messages Scrapper
- Download Media
- HTML Report Generation
- Export Downloaded Files
- Export Messages


<!-- 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/)

