Skip to main content

Parser and analytics tools for WhatsApp group chats

Project description


Package version

Build StatusGitHub license GitHub stars GitHub forks

whatstk is a Python module for WhatsApp chat group analysis and distributed under the GPL-3.0 license.

The project was started in December 2016 by lucasrodes and albertaparicio.

:star: Please star our project if you found it interesting to keep us motivated :smiley:!


Tested on Python 3.7

pip install whatstk

Getting Started

Obtain a dataframe from your chat log file

Export your WhatsApp chat using your phone and send it to your computer. Make sure to choose the correct format of the header. In the example here, the header (see example.txt) uses the syntax '%d.%m.%y, %H:%M - %name:'. Header example: 07.08.2016, 19:30 - Misty:

from whatstk.core import WhatsAppChat

filename = 'chats/example.txt'
# [IMPORTANT] Choose header format accordingly
hformat = '%d.%m.%y, %H:%M - %name:'
chat = WhatsAppChat.from_txt(filename, hformat)

Plot the cumulative messages sent by day

Once you have your chat object, you can visualise the cumulative number of messages sent per day using the following code

from whatstk.core import interventions
counts = interventions(chat, 'date', msg_length=False)
counts_cumsum = counts.cumsum()

# Plot result
from plotly.offline import plot
from whatstk.plot import vis
plot(vis(counts_cumsum, 'cumulative characters sent per day'))

Note: More examples to come soon.


We are very open to have collaborators. You can freely fork and issue a pull request with your updates! For other issues/bugs/suggestions, please report it as an issue or text me.

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.1.11
Filename, size File type Python version Upload date Hashes
Filename, size whatstk-0.1.11.tar.gz (27.9 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