whatstk is a python package providing tools to parse, analyze and visualize WhatsApp chats developed under the sociepy project. Easily convert your chats to csv or simply visualize statistics using the python library. The package uses pandas to process the data and plotly to visualise it.
First contact with whatstk¶
Below, we use the WhatsApp implementation, i.e.
WhatsAppChat, to load LOREM chat. To test it with your own
chat, simply export it as a txt file to your computer and then use class argument
shown in the following example.
>>> from whatstk.whatsapp.objects import WhatsAppChat >>> from whatstk.data import whatsapp_urls >>> chat = WhatsAppChat.from_source(filepath=whatsapp_urls.LOREM) >>> chat.df.head(5) username message date 2020-01-15 02:22:56 Mary Nostrud exercitation magna id. 2020-01-15 03:33:01 Mary Non elit irure irure pariatur exercitation. 🇩🇰 2020-01-15 04:18:42 +1 123 456 789 Exercitation esse lorem reprehenderit ut ex ve... 2020-01-15 06:05:14 Giuseppe Aliquip dolor reprehenderit voluptate dolore e... 2020-01-15 06:56:00 Mary Ullamco duis et commodo exercitation.
Installation & compatibility¶
This project is on PyPI, install it with pip:
pip install whatstk
Project has been tested with Python 3.7-3.8.
Clone the project from the official repository
git clone https://github.com/lucasrodes/whatstk.git
and install it locally
cd whatstk pip install .
For more details, refer to the contribute section.
Why this name, whatstk?¶
whatstk stands for “WhatsApp Toolkit”, since the project was initially conceived as a python library to read and process WhatsApp chats.