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 Documentation Status Tutorial Python 3 Number of downloads 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

Install develop version (not stable):

pip install git+

More details here

Getting Started

For a rapid introduction, check this tutorial on Medium.

Export your chat using your phone:

See instructions.

Load chat as a DataFrame

from whatstk import df_from_txt_whatsapp
df = df_from_txt_whatsapp("path/to/chat.txt")

Convert chat to csv

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

More examples

See more in sections getting started and examples.


See official documentation.


See contribute section.




Lucas Rodés-Guirao. "whatstk, WhatsApp analysis and parsing toolkit",

Covered in

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.5.0
Filename, size File type Python version Upload date Hashes
Filename, size whatstk-0.5.0.tar.gz (47.0 kB) File type Source Python version None Upload date Hashes View

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