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+

Install development version

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 df_from_whatsapp

# Load chat into a DataFrame
df = df_from_whatsapp("path/to/chat.txt")

# Or directly from iOS zip export
df = df_from_whatsapp("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 plot_user_message_count

# Interactive message count chart
fig = plot_user_message_count(df)
fig.show()

Documentation

Full documentation available at whatstk.readthedocs.io

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

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

⭐ Star this repo if you find it useful!

Made with ❤️ by Lucas Rodés-Guirao

Metadata

Release files for whatstk 0.8.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for whatstk 0.8.1
File	Size	Uploaded
whatstk-0.8.1.tar.gz	17.7 MB	Nov 24, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for whatstk 0.8.1
File	Interpreter	ABI	Platform	Reset
whatstk-0.8.1-py3-none-any.whl 54.5 kB Nov 24, 2025	Python 3	none	any	Details

Total release size: 17.8 MB

Release files / whatstk-0.8.1.tar.gz

Download URL	whatstk-0.8.1.tar.gz
Size	17.7 MB
Tags	Source
SHA-256 checksum How to use checksums	`7181aa07d76903d78fd0a6f6da6b2d81028c8b57018f692cbb66b443c6607f0a`
BLAKE2b-256 checksum How to use checksums	`0d9ae4ba0684a93a3184c0be76bce3bef9787a329149f4050a6ec45d0d025579`
Upload date	Nov 24, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/lucasrodes/whatstk
Publishing commit: github.com/lucasrodes/whatstk/tree/ba408401490e6dd3ded77e95fa335a510b374518

Workflow

Publishing configuration: github.com/lucasrodes/whatstk/blob/ba408401490e6dd3ded77e95fa335a510b374518/.github/workflows/release.yml
Publishing logs: github.com/lucasrodes/whatstk/actions/runs/19619786677/attempts/1

Artifact

Subject: whatstk-0.8.1.tar.gz
SHA-256 checksum: 7181aa07d76903d78fd0a6f6da6b2d81028c8b57018f692cbb66b443c6607f0a Verifying attestations

Release files / whatstk-0.8.1-py3-none-any.whl

Download URL	whatstk-0.8.1-py3-none-any.whl
Size	54.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`f35a9fc64a3a56432de503cbaece08d1425366b8e4c69b57ac895f72a9ac8c66`
BLAKE2b-256 checksum How to use checksums	`83d073e43441153e320fb0a042a41e09cfc04819940ed7ca10b17263a838a300`
Upload date	Nov 24, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/lucasrodes/whatstk
Publishing commit: github.com/lucasrodes/whatstk/tree/ba408401490e6dd3ded77e95fa335a510b374518

Workflow

Publishing configuration: github.com/lucasrodes/whatstk/blob/ba408401490e6dd3ded77e95fa335a510b374518/.github/workflows/release.yml
Publishing logs: github.com/lucasrodes/whatstk/actions/runs/19619786677/attempts/1

Artifact

Subject: whatstk-0.8.1-py3-none-any.whl
SHA-256 checksum: f35a9fc64a3a56432de503cbaece08d1425366b8e4c69b57ac895f72a9ac8c66 Verifying attestations