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. You can use this more than once. -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.
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.
- Reintroducing advanced tools as part of the package.
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.
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 telepathy-1.1.12-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 855b9df0dfe1681afbbaad41a2756d74cca9bb00dc67bb6b49665b0042709f75 |
|
MD5 | e3063e1a691345183e825669afd2f0f1 |
|
BLAKE2b-256 | 877770bf83ceeb0b0ad344ca970cb4e60ea18fea21fe27722cdd1e7d3538c447 |