/whatstk

Python toolkit to analyse and parse WhatsApp chats.

Primary LanguagePythonGNU General Public License v3.0GPL-3.0



whatstk: analyze WhatsApp chats with python

Package version

Build Status codecov Python 3 Documentation Number of downloads HitCount GitHub
license Join the chat at https://gitter.im/sociepy/whatstk

whatstk is a python package providing tools to parse, analyze and visualise WhatsApp chats developed under the sociepy project. Easily convert your chats to csv or simply visualise some stats using the provided command-line tools or python. The package uses pandas to process the data and plotly to visualise it.

It is distributed under the GPL-3.0 license.

⭐ Please star our project if you found it interesting to give us some dopamine 😄!

Content

Installation

pip install whatstk

Getting Started

Export your chat using your phone:

Follow these instructions.

Convert chat to csv

Easily convert your txt chat file to csv using command whatstk-to-csv.

$ whatstk-to-csv [input_filename] [output_filename]

Load chat in python

You can also load the exported txt file with python.

from whatstk import WhatsAppChat
from whatstk.data import whatsapp_urls
chat = WhatsAppChat.from_source(filepath=whatsapp_urls.LOREM)

More examples

Find more examples in the getting started and examples sections.

Documentation

See official documentation.

Contribute

See contribute section.

License

GPL-3.0