tg-chat-visual

KO | EN

gitlite — search

#python #llm #golang #go #rust #deep-learning #docker #macos #awesome #vue #pytorch #ios #openai #open-source

(★ 13)

Telegram Chat History Visualization.

tg-chat-visual Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Telegram Chat History Visualization

[![forthebadge made-with-python](http://ForTheBadge.com/images/badges/made-with-python.svg)](https://www.python.org/)

> “I would rather spend one lifetime with you, than face all the ages of this world alone.“
> 
>  J.R.R. Tolkien

## Prerequisite

```
pip3 install beautifulsoup4 emoji
```

## Usage

### Export the specific Telegram Chat History

Click 「Export chat history」 on the top right corner of Telegram Desktop.

![](https://raw.githubusercontent.com/n0vad3v/tg-chat-visual/master/export-tg.png)
![](https://raw.githubusercontent.com/n0vad3v/tg-chat-visual/master/export.png)

In a typical export of Telegram message folder, there will be files like this:

```
.
├── css
│   └── style.css
├── images
├── js
│   └── script.js
├── messages2.html
├── messages3.html
├── messages4.html
├── messages5.html
├── messages.html
└── stickers
```

Just put the `parse.py` with those `.html`s.

### Parse the Logs

Run
```
python3 parse.py
```
and your chat log will be in `chat_history.csv` like this:

![](https://raw.githubusercontent.com/n0vad3v/tg-chat-visual/master/chat_log.png)

### Visualize those Logs

Run `tg-report.ipynb` in Jupyter Notebook, if you don't have one, you may try it out in [Google Colab](https://colab.research.google.com).

![](https://raw.githubusercontent.com/n0vad3v/tg-chat-visual/master/jupyter.png)

## Play with data

First of all, we can know how many chat items are there, maybe using WC?

```
➜  cat chat_history.csv | wc -l
629529
```

How many times we say "Good Night" to each other?

```
➜  cat chat_history.csv | grep "晚安" | wc -l
504213
```

Wow, the "Good Night rate" is about 80%.

## Visualizations

Here are the example visualizations with generated data samples.

### Date-Chat Chart

![](https://raw.githubusercontent.com/n0vad3v/tg-chat-visual/master/date-chat.png)

### Time-Chat Chart

![](https://raw.githubusercontent.com/n0vad3v/tg-chat-visual/master/time-chat.png)

### Wordcloud

Of course we have this feature, but due to the possiblity of leaking sensitive data, I cannot provide a screenshot here, it's for your discovery.

tg-chat-visual

tg-chat-visual Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

tg-chat-visual

tg-chat-visual Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README