lucasrodes / whatstk

WhatsApp chats as dataframes. Python toolkit to analyse and parse WhatsApp chats.
https://whatstk.lcsrg.me/
GNU General Public License v3.0
125 stars 21 forks source link
machinelearning pandas pandas-dataframe parser whatsapp whatsapp-analysis whatsapp-group whatsapp-parser whatsapp-statistics

whatstk: analyze WhatsApp chats with python

Package version

Build Status codecov Documentation Status Tutorial Python 3 Number of downloads GitHub license


Try the live demo parser to convert your chats to CSV


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 😄!

Content

Installation

pip install whatstk

Install develop version (not stable):

pip install git+https://github.com/lucasrodes/whatstk.git@develop

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_whatsapp
df = df_from_whatsapp("path/to/chat.txt")

NOTE: You can now also load directly from a zip chat (iOS export).

Convert chat to csv

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

More examples

_See more in sections getting started and examples._

Documentation

See official documentation.

Contribute

See contribute section.

License

GPL-3.0

Citation

Lucas Rodés-Guirao. "whatstk, WhatsApp analysis and parsing toolkit", https://github.com/lucasrodes/whatstk

Covered in