macOS SwiftUI app for turning exported WhatsApp chat logs (_chat.txt) into readable HTML archives (WhatsApp-like bubble view) and Markdown that open in standard browsers.
- Parses common WhatsApp TXT export formats (DE/EN variants).
- Preserves multi-line messages and system notices.
- Produces HTML archives and Markdown summaries for long-term reading.
- WhatsApp-style HTML layout with day separators, timestamps, and link previews.
- Attachment handling with optional embedding, thumbnails, or sidecar references.
- Sidecar export for faster loading and smaller HTML files.
- macOS GUI with export presets and best-effort participant detection.
HTML variants (suffixes are part of the filename):
-max— single HTML file with all media embedded (best offline portability).-mid— HTML with embedded thumbnails, large media kept external.-min— text-only HTML (smallest, email-friendly).-sdc— sidecar HTML that references media files in a folder for fast loading.
Markdown:
- One
.mdfile grouped by day with timestamps and attachment references.
The macOS UI focuses not only on data conversion, but also on a high-quality Apple Intelligence-style glow (Dark + Light) that closely matches the Apple-like AI glow appearance on macOS. Screenshots below show the current default (Siri Pill palette).
A legacy Python script remains in the repo for reference/backward compatibility, but it is not actively developed. The actively maintained implementation is the macOS SwiftUI app.
- Legacy script:
whatsapp_export_to_md_html.py
- Open the Xcode project.
- Select the
whatsapp-export-toolsscheme. - Build & Run.
- Chat-Export auswählen: select the exported WhatsApp TXT file (typically
_chat.txt). - Zielordner auswählen: choose where the exports should be written.
- Chat-Partner: select the counterparty (auto-detected when possible).
- Choose the desired output variants (HTML + Markdown + Sidecar).
- Click Exportieren.
- Keep the WhatsApp export TXT and its attachment files in the same folder during export.
- Some URLs (notably Google services) may show consent/interstitial pages; link preview handling is best-effort.
MIT License – siehe LICENSE.
“WhatsApp” ist eine Marke von WhatsApp LLC. Dieses Projekt ist nicht mit WhatsApp/Meta verbunden und wird nicht von ihnen unterstützt.



