# whatstk

Parse, analyze, and visualize WhatsApp chats with Python

Documentation • Try Live Demo • Tutorial

Features

• 📱 Parse WhatsApp exports from Android and iOS (including zip files)
• 🐼 Convert to pandas DataFrames for easy analysis
• 📊 Interactive visualizations powered by Plotly
• 🔧 Command-line tools for quick CSV conversions
• 🌍 Multi-language support for various WhatsApp date formats
• 🚀 Fast and efficient processing of large chat histories

Installation

pip install whatstk

Requirements: Python 3.11+

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

Quick Start

Export your WhatsApp chat

Follow the export instructions for your device.

Load and analyze

from whatstk import dffromwhatsapp
Load chat into a DataFrame
df = dffromwhatsapp("path/to/chat.txt")
Or directly from iOS zip export
df = dffromwhatsapp("path/to/chat.zip")
Now use pandas to analyze
print(df.head())

Convert to CSV

whatstk-to-csv input_chat.txt output.csv

Visualize

from whatstk.graph import plotusermessage_count
Interactive message count chart
fig = plotusermessage_count(df)
fig.show()

Documentation

Full documentation available at whatstk.readthedocs.io

• Getting Started Guide
• Code Examples
• API Reference

Contributing

We welcome contributions! See our contribution guide to get started.

License

This project is licensed under the GPL-3.0 License.

Citation

If you use whatstk in your research or project, please cite:

@software{whatstk,
  author = {Rodés-Guirao, Lucas},
  title = {whatstk: WhatsApp analysis and parsing toolkit},
  url = {https://github.com/lucasrodes/whatstk},
  year = {2025}
}

or as

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

Featured Projects

• Your WhatsApp Chat History in Cool Graphs by @batmanscode
• WhatsAppening to the news by @enric1994
• Summary Analysis of My WhatsApp Chats by N.M. Danial
• From Chat to Insights: Analyzing WhatsApp Group Conversations by Erland Sada
• Building a Chatbot: Fine-Tune LLMs with WhatsApp Data by Daniel Pleus

[!NOTE]

If you have created a project using whatstk, I'd love to know that and add it this list! Thanks a lot!