---
A web app that takes chat exports from supported platforms and generates a single HTML file containing information, statistics and interactive graphs about them. Privacy is its main concern; chat data never leaves the device when generating reports. Selfhost with Docker!
| π¬ MESSAGES | π °οΈ LANGUAGE | π EMOJI | π LINKS | π CALLS | π INTERACTION | π SENTIMENT | π TIMELINE |
|--|--|--|--|--|--|--|--|
| | | | | | | | |
You can interact with [the demo here](https://chatanalytics.app/demo)!
## Chat platform support
You can generate reports from the following platforms:
| Platform | Formats supported | Text content | Edits & Replies | Attachment Types | Reactions | Profile picture | Mentions | Calls |
|-----------|----------------------------------------------------------------------------------|--------------|------------------|-------------------------------------------------------------------------------------|------------------|------------------------|-------------|-------|
| Discord | `json` from [DiscordChatExporter](https://github.com/Tyrrrz/DiscordChatExporter) | β | β | β | β | β (until link expires) | β (as text) | β |
| Messenger | `json` from [Facebook DYI export](https://www.facebook.com/dyi) | β | β | β | β | β | β (as text) | β |
| Telegram | `json` from [Telegram Desktop](https://desktop.telegram.org/) | β | β | β | β (not provided) | β | β (as text) | β |
| WhatsApp | `txt` or `zip` exported from a phone | β | β (not provided) | β * (if exported from iOS) π¦ (generic if exported from Android) | β (not provided) | β | β (as text) | β |
* not all languages are supported, check [WhatsApp.ts](/pipeline/parse/parsers/WhatsApp.ts).
You can't combine exports from different platforms.
The contribution of [new platform parsers](/docs/PIPELINE.md#writing-a-new-parser) is always welcomed π
## Privacy & Analytics
Since all chat data always stays in the browser, there is zero risk of someone reading your chats. Note that **the report HTML file contains sensitive information** (one may reconstruct message contents for every message), so share your reports with people you trust.
The site does not use cookies either and uses a self-hosted version of [Plausible](https://plausible.io). All events do not contain PII and the information is segmented (e.g. 1MB-10MB, etc.). Since I want full transparency, you can check the [site analytics here](https://p.chatanalytics.app/chatanalytics.app).
## CLI
You can generate reports from the command line using `npx chat-analytics`:
```
Usage: chat-analytics -p -i
Options:
--help Show help [boolean]
--version Show version number [boolean]
-p, --platform The platform to generate for
[string] [required] [choices: "discord", "messenger", "telegram", "whatsapp"]
-i, --inputs The input file(s) to use (glob) [array] [required]
-o, --output The output HTML filename [string] [default: "report.html"]
--demo Mark the report as a demo [boolean] [default: false]
```
For example:
```sh
npx chat-analytics -p discord -i "exported/*.json" -o report.html
```
## Docs & Development
You can read [docs/README.md](/docs/README.md) for technical details, and [docs/DEV.md](/docs/DEV.md) for development instructions.
In [docs/TODO.md](/docs/TODO.md) you can find ideas and pending stuff to be implemented.
## Acknowledgements
* [FastText](https://fasttext.cc/), a library by Facebook for efficient sentence classification. MIT licensed.
* [lid.176.ftz model](https://fasttext.cc/docs/en/language-identification.html), provided by FastText developers for language identification. Distributed under [CC BY-SA 3.0](https://creativecommons.org/licenses/by-sa/3.0/).
* [multilang-sentiment](https://github.com/marcellobarile/multilang-sentiment), for the translated AFINN database. MIT licensed.
* Emoji sentiment data from the work of Kralj Novak, Petra; SmailoviΔ, Jasmina; Sluban, Borut and MozetiΔ, Igor, 2015, Emoji Sentiment Ranking 1.0, Slovenian language resource repository CLARIN.SI, http://hdl.handle.net/11356/1048. Licensed with [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/).
* [stopwords-iso](https://github.com/stopwords-iso/stopwords-iso) for a collection of stopwords in a variety of languages. MIT licensed.
* All the libraries and tools that made this project possible π
## License
AGPLv3. See [LICENSE](LICENSE).
| 
| 
| 
| 
| 
| 
|
You can interact with [the demo here](https://chatanalytics.app/demo)!
## Chat platform support
You can generate reports from the following platforms:
| Platform | Formats supported | Text content | Edits & Replies | Attachment Types | Reactions | Profile picture | Mentions | Calls |
|-----------|----------------------------------------------------------------------------------|--------------|------------------|-------------------------------------------------------------------------------------|------------------|------------------------|-------------|-------|
| Discord | `json` from [DiscordChatExporter](https://github.com/Tyrrrz/DiscordChatExporter) | β
| β
| β
| β
| β
(until link expires) | β
(as text) | β
|
| Messenger | `json` from [Facebook DYI export](https://www.facebook.com/dyi) | β
| β | β
| β | β | β
(as text) | β |
| Telegram | `json` from [Telegram Desktop](https://desktop.telegram.org/) | β
| β
| β
| β (not provided) | β | β
(as text) | β
|
| WhatsApp | `txt` or `zip` exported from a phone | β
| β (not provided) | β
* (if exported from iOS)