An OSINT toolkit for investigating Telegram chats.
Project description
Telepathy: An OSINT toolkit for investigating Telegram chats.
Installation
Install from source
git clone https://github.com/jordanwildon/Telepathy.git
Navigate to the installation directory cd telepathy and run setup.py, this will set up the tool and install all the necessary dependencies.
sudo python3 setup.py install
or
pip3 install telepathy
Then register for and obtain your Telegram API details from my.telegram.org.
Usage
Upon installation completion, you will be able to use Telepathy. On first use, Telepathy will ask for your API details and then an authorization code that will be sent to your Telegram account. If you have two-factor authentication enabled, you'll be asked to input your Telegram password.
Usage: telepathy [OPTIONS]
Telepathy is an OSINT toolkit for investigating Telegram chats.
Options: --verbose Prints output to the terminal. -n, --name TEXT Specifies a chat to investigate. -a, --archive Archives the specified chat. -m, --media Archives media in the specified chat. -f, --forwards Scrapes forwarded messages. -p, --participants Scrapes members from the specified group. -u, --user TEXT Looks up a specified user ID. -i, --info TEXT Looks up a specified channel by ID. -l, --location TEXT Finds users near to specified coordinates. --help Show this message and exit.
Advanced tools
User Analysis tool Telepathy comes with an additional a user analysis tool that analyzes the post frequency of users based on archived chats. The tool works by gathering all CSV archives in the "./telepathy/advanced/analysis*dropbox" folder. Simply drop a selection of group archives into this folder and it will calculate the number of unique active posters and how often they have posted.
Usage:
cd ./advanced/analysis_dropbox python3 user_analysis.py > analysis.csv
nb. when a user joins a group, it is considered a post in the above analysis. This is a tiny bug with Telepathy and will eventually be fixed but has been currently left in as it's still considered a signal of activity.
recon.py This tool will take a list of chat URLs (in the format of a to_archive.csv) then list basic information and the number of participants in each chat. Scheduled to run once a day, this can help you monitor the growth of a particular list of channels over time.
A note on how Telegram works
Telegram chats are organised into two key types: channels and megagroups/supergroups. Each module works slightly differently depending on the chat type. For example, subscribers of Channels can't be scraped with the members.py module. Channels can have seemingly unlimited subscribers, megagroups can have up to 200,000 members.
** Upcoming changes ** With the release of the Telepathy CLI interface, the toolkit has entered its next stage of production. Despite this, some bugs may still be present and some features are yet to be added. In some environments (particularly Windows), Telepathy struggles to effectively manage files and can sometimes produce errors. Fixes for these errors will come in due course.
Upcoming features include:
- Re-adding a time specification flag for the archive module to set archiving for specific period.
- Giving the archiver module the ability to archive comments on channel posts.
- Reintroducing batch archiving based on a to_archive.csv.
Feedback
Please send feedback to @jordanwildon on Twitter
Usage terms
You may use Telepathy however you like, but your usecase is your responsibility. Be safe and respectful.
Credits
All tools created by Jordan Wildon (@jordanwildon). Alex Newhouse (@AlexBNewhouse) contributed to the early release of Telepathy.
Where possible, credit for the use of this tool in published research is desired, but not required.
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 telepathy-1.1.7-py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | a4ebc8f181fe33b9be851a700c8039ce92a1b85a0fb57dc7a8e92ca11af34256 |
|
| MD5 | b357a721fcd44d7593316cc776e7377d |
|
| BLAKE2b-256 | f55ea4ac9b8fd3fd9dd8b7b344027cb9993cb59a6e0e885b88345146795b4363 |
