Skip to main content

How about another exported Telegram Chat analyzer? ๐Ÿ˜‰

Project description



How about another exported Telegram Chat analyzer ? :wink:


Telegram + ( Chat ) Analyze = tgnize


  • I'm always interested in learning more about data, which is why I thought about taking a deeper look into Telegram Chats ( mostly groups ), I participate in.
  • I exported chat data ( excluding audios, videos and images etc. ), of Devs Chat group, using Telegram Desktop Client, which are nothing but some HTML, CSS & JS files
  • I created an object model, into which I populated parsed Chat data, so that I can manipulate it well
  • Then I started plotting animated charts & much more ( a lot of work remaining though ), to depict how participants contributed to chat
  • It also lets me understand my chat activity pattern(s) i.e. in which hour of the day I'm mostly active / inactive in Chat
  • Or how another peer is spending their time is Chat
  • What's mostly used words / mostly used bots / mostly used Emoji etc. in Chat


This project doesn't expect you to use any exported Chat for manipulating any participant or use extracted data ( sleep patterns, daily activity pattern of participants ) for doing some harmful activity to any participant.

If users use it for malicious purpose(s), it's not author's responsibility !!!

I suggest you not to use it for manipulating someone else. Thank you for understanding :wink:

data source

Here I'm using Devs Chat's, exported Chat data set for testing these scripts. So all plots ( to be :wink: ) generated, present in this repository, are result of application of scripts on Devs Chat's exported Chat data.

Template data set is present here. It holds all messages of Devs Chat upto 03/11/2019 from initialization of group.

For respecting privacy of all users, I'm removing that data source from this public repo. Export chat data for your own need.

exporting chat

For exporting chat data for Devs Chat group of Telegram, I used Official Telegram Desktop Client. Exporting was done, while only including text messages ( no images, videos or audios ), which are nothing but a bunch of HTML files.

If you want to run these scripts on your machine, make sure you've Telegram Desktop Client installed.

$ sudo snap install telegram-desktop # run on your linux terminal

Log into your account and choose which chat to export. Well this expoting procedure can take some time, depending upon age & activeness of Chat.


  • Download this zip from here
  • Unzip it into a suitable directory on your machine
  • Get into tgnize directory
$ cd tgnize
$ tree -h
โ”œโ”€โ”€ [4.2K]
โ”œโ”€โ”€ [4.0K]  docs
โ”‚ย ย  โ””โ”€โ”€ [1.8K]
โ”œโ”€โ”€ [ 227]  install
โ”œโ”€โ”€ [1.0K]  LICENSE
โ”œโ”€โ”€ [4.0K]  model
โ”‚ย ย  โ”œโ”€โ”€ [ 245]
โ”‚ย ย  โ”œโ”€โ”€ [9.8K]
โ”‚ย ย  โ”œโ”€โ”€ [ 332]
โ”‚ย ย  โ”œโ”€โ”€ [ 100]
โ”‚ย ย  โ”œโ”€โ”€ [1.3K]
โ”‚ย ย  โ”œโ”€โ”€ [ 515]
โ”‚ย ย  โ””โ”€โ”€ [1.1K]
โ”œโ”€โ”€ [4.0K]  plotting_scripts
โ”‚ย ย  โ”œโ”€โ”€ [ 100]
โ”‚ย ย  โ”œโ”€โ”€ [ 169]
โ”‚ย ย  โ””โ”€โ”€ [ 11K]
โ”œโ”€โ”€ [2.7K]
โ”œโ”€โ”€ [  56]  requirements.txt
โ”œโ”€โ”€ [  47]  tgnize
โ””โ”€โ”€ [4.4K]

3 directories, 18 files
  • Make sure you've python3-pip installed, which will be required for installing python modules ( i.e. beautifulsoup4, matplotlib etc. )
  • Run install script ( BASH script ), which will download all required dependencies into your machine
$ ./install
  • For generating animated plots, you'll need to have imagemagick installed on your machine. Install it using your system package manager.
$ sudo apt-get install imagemagick # for debian based distros
$ sudo dnf install imagemagick # for fedora
  • Now you need to add installation path of tgnize, into your PATH variable
$ pwd # copy it
  • If you're on BASH, find .bashrc under your home directory, if not found create a file with that name
  • Add follwing line at end of that file, while replacing paste-here section with installation path of tgnize
export PATH="$PATH:paste-here"
  • Now close this terminal window & open a new one
  • You'll have tgnize, executable BASH script present under downloaded zip, on your path. Simply invoke tgnize directly, to be sure things are working as they're supposed to be
$ cd # get to home directory
$ tgnize
[+]tgnize v0.1.0 - How about another Telegram Chat Analyzer ?

	$ tgnize `path-to-exported-chat-dir` `path-to-sink-dir`

[+]Author: Anjan Roy<>
[+]Source: ( MIT Licensed )

[!]Error : Improper Invocation of `tgnize`
  • It's asking you to properly invoke script, by giving source directory ( holding exported telegram chat, of a single Chat, may be a lot of files in case of large Chats ) & sink directory ( will hold generated plots / charts )
  • If you've already exported some Telegram chat, consider invoking this script, to understand how you spent your time in Chat


This project is in its infancy, a lot of features to be added. If you've something in your mind, don't hesitate to create an issue or make a PR

Got some new idea ? Make a PR :wink:

Work in Progress - coming with more details soon

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tgnize-0.1.2.tar.gz (16.0 kB view hashes)

Uploaded source

Built Distribution

tgnize-0.1.2-py3-none-any.whl (46.8 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page