# KnugiHK/WhatsApp-Chat-Exporter

A customizable, cross-platform tool for parsing WhatsApp chat databases from Android and iOS/iPadOS backups. Supports Android .crypt12, .crypt14, .crypt15, and the latest database formats. Outputs chat history in readable HTML or structured JSON.

Repository: https://github.com/KnugiHK/WhatsApp-Chat-Exporter
Canonical: https://ross.abutalabs.com/products/whatsapp-chat-exporter
Homepage: https://wts.knugi.dev/
Language: Python
License: MIT
License Family: permissive
Topics: whatsapp, whatsapp-export, whatsapp-database, android, ios, iphone, whatsapp-database-parser, parsing, whatsapp-conversations, history, iphone-backup, customizable, android-backup, crypt12, crypt14, crypt15, message, messages, sticker, full
Last push: 2026-08-12T12:21:46+00:00

## Health v2 (maintenance only)
Score: 83/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 97, release rhythm 55, longevity 100
- inputs: {"age_days": 2061, "days_push": 21, "days_rel": 221, "gap_med": 70, "n_releases_24m": 6}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1204, forks 161 (observed 2026-08-28T04:03:59.096118+00:00)

## What it is
A customizable Python CLI tool that parses WhatsApp chat databases from Android and iOS/iPadOS backups, including decryption of crypt12/14/15 encrypted backups. It exports conversation history with media into readable HTML, JSON, or text formats.

## Use cases
- export whatsapp chat history to html
- decrypt whatsapp crypt15 backup
- parse whatsapp msgstore.db from android
- extract whatsapp messages from iphone backup
- convert whatsapp database to json
- backup whatsapp conversations before deleting account
- export whatsapp media and stickers

## When to choose
- you need cross-platform WhatsApp export for both Android and iOS backups
- you want customizable HTML templates or machine-readable JSON output
- you need to decrypt crypt12/14/15 encrypted backups
- you want filtering by date or phone number

## When to avoid
- you need a GUI-based one-click exporter
- you cannot access the WhatsApp database or backup files at all
- you want to export from platforms other than WhatsApp (e.g. Telegram, Signal)

## Facets
- artifact type: cli-tool
- maturity: active
- function: parser, pdf, json, developer-tools
- domain: files, privacy, developer-tools, cross-platform
- platform: python, cli, cross-platform
- tags: whatsapp, chat-export, backup-decryption, crypt12, crypt14, crypt15, html-export, message-history, iphone-backup, android-backup, android, ios

## Member repositories
- KnugiHK/WhatsApp-Chat-Exporter (main) score 83

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:59.096118+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:19:37.934346+00:00, confidence not recorded.
  - readme: https://github.com/KnugiHK/WhatsApp-Chat-Exporter (fetched 2026-08-28T04:03:59.096118+00:00, sha 8e631949db98)
  - homepage: https://wts.knugi.dev/ (fetched 2026-08-29T12:27:13.977097+00:00, sha 433929df2942)
- Data as of 2026-08-30T08:39:29.467469+00:00.
