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) date username message 0 2020-01-15 02:22:56 Mary Nostrud exercitation magna id. 1 2020-01-15 03:33:01 Mary Non elit irure irure pariatur exercitation. 🇩🇰 2 2020-01-15 04:18:42 +1 123 456 789 Exercitation esse lorem reprehenderit ut ex ve... 3 2020-01-15 06:05:14 Giuseppe Aliquip dolor reprehenderit voluptate dolore e... 4 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 in Python>=3.7.
Clone the project from the official repository and install it locally
git clone https://github.com/lucasrodes/whatstk.git cd whatstk pip install .
To use Google Drive or Chat Generation support, install the library along with the corresponding extensions:
pip install whatstk[gdrive]
pip install whatstk[generate]
Or install the full suite:
pip install whatstk[full]
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.