WhatsApp Chat Exporter
Open sourceActive
Latest GitHub release 0.13.1 (2026-10-11); PyPI lists the same version uploaded 2026-10-11. Not tested.
WhatsApp Chat Exporter is a Python command-line tool (wtsexporter) that parses WhatsApp databases from Android devices and from iOS/iPadOS backups and writes the conversations as HTML, JSON or text. It can decrypt Android crypt12, crypt14 and crypt15 backups when the key is supplied. The README is written for people exporting their own chat history and describes no forensic workflow or evidence handling.
Facts
| Website | github.com |
|---|---|
| Vendor | Knugi (KnugiHK) and contributors |
| Licence | Open source (MIT (LICENSE file in the repository; the README also states it is an MIT licensed project)) |
| Category | Artefact parsers |
| Functions | Parsing, Decoding, Reporting |
| Targets | Android, iOS, iPadOS |
| Runs on | Python 3 (pip install whatsapp-chat-exporter), Windows, macOS, Linux |
| Pricing | Free |
| Users | Open-source DFIR community, Research |
| Last activity | 2026-10-25 · Latest commit on the default branch (README update); release 0.13.1 published 2026-10-11 [github.com] |
| GitHub activity | KnugiHK/WhatsApp-Chat-Exporter · 1,305 stars · last push 2026-11-10 · latest release 0.13.1 (2026-10-11) · checked 2026-11-10 |
Capabilities
- Parses WhatsApp databases from Android (msgstore.db, optionally with the wa.db contact database and the media folder) and from iOS/iPadOS iTunes/Finder backups, and writes the conversations as HTML and JSON. [github.com]
- Decrypts Android crypt12, crypt14 and crypt15 backups with a key file, or with the 32-byte (64 hexadecimal digit) key for end-to-end encrypted crypt15 backups; the decryption dependency (pycryptodome) is an optional install extra, and crypt15 additionally needs the separate crypt15 extra (javaobj-py3). [github.com]
- Offers a plain-text export similar to WhatsApp's own, a Telegram-compatible JSON layout, per-chat JSON files, filters by date and by phone number, and a WhatsApp Business option. [github.com]
- Can enrich contact names from a vCard export, and has an incremental-merge option for two exports (chats as JSON files, plus media) that adds new messages and media to the target directory without deleting existing ones. [github.com]
Limitations
- Decrypting an Android crypt12 or crypt14 backup needs the key file from the phone; the README says it can be found at /data/data/com.whatsapp/files/key with root access, or obtained with the author's separate WhatsApp-Key-DB-Extractor, which it says works only on Android 4.0 to 13. The exporter does not obtain the key itself. [github.com]
- For an encrypted iOS/iPadOS backup the README tells the user to install the separate iphone_backup_decrypt library, and says WhatsApp's built-in end-to-end encryption for its own backups must be disabled first. [github.com]
Links
Related tools
- iphone-backup-decrypt · Utilities and libraries
- WhatsApp Crypt Tools · Artefact parsers
- Elcomsoft Explorer for WhatsApp · Acquisition
- ALEAPP · Artefact parsers
Sources
Reviewed . Spotted an error? See the corrections policy.