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 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 here.


See official documentation.


See contributing 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.3.0b0
Filename, size File type Python version Upload date Hashes
Filename, size whatstk-0.3.0b0.tar.gz (36.4 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page