Skip to main content

Parser and analytics tools for WhatsApp group chats

Project description

whatstk: analyze WhatsApp chats with python

Package version

Build Status codecov Python 3 Documentation Number of downloads HitCount GitHub
license Join the chat at

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 😄!



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 import whatsapp_urls
chat = WhatsAppChat.from_source(filepath=whatsapp_urls.LOREM)

More examples

Find more examples in the getting started and examples sections.


See official documentation.


See contribute section.



Project details

Download files

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

Files for whatstk, version 0.4.0.dev0
Filename, size File type Python version Upload date Hashes
Filename, size whatstk-0.4.0.dev0.tar.gz (36.9 kB) File type Source Python version None Upload date Hashes View

Supported by

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