# Read a Telegram result.json Export Paste a Telegram Desktop result.json export and get a clean transcript, per-sender message and word stats, top words and emoji. Runs locally. ## Run it - **CLI:** `gizza tool telegram-export-reader '{"name":"Weekend Trip","type":"private_group","messages":[{"type":"message","date":"2021-03-27T14:45:00","from":"Alice","text":"Hey everyone ready for the trip"}]}'` - **Web:** https://gizza.ai/tools/telegram-export-reader/ - **Agents:** machine-readable descriptor (parameters JSON Schema) at https://gizza.ai/tools/telegram-export-reader/tool.json ## Inputs - `export` — Telegram result.json _(field)_ - `output` — Output _(field)_ - `include_service_messages` — Include service messages (joins, title changes, calls) _(field)_ - `sender_filter` — Sender filter _(field)_ - `max_messages` — Max messages (0 = all) _(field)_ ## Output - Transcript / stats (text) ## Query parameters Open the tool pre-filled and auto-run via URL: - `export` — Telegram result.json - `output` — Output - `include_service_messages` — Include service messages (joins, title changes, calls) - `sender_filter` — Sender filter - `max_messages` — Max messages (0 = all) Example: `https://gizza.ai/tools/telegram-export-reader/?export=%7B%22name%22%3A%22Weekend%20Trip%22%2C%22type%22%3A%22private_group%22%2C%22messages%22%3A%5B%7B%22type%22%3A%22message%22%2C%22date%22%3A%222021-03-27T14%3A45%3A00%22%2C%22from%22%3A%22Alice%22%2C%22text%22%3A%22Hey%20everyone%20ready%20for%20the%20trip%22%7D%5D%7D&output=both&include_service_messages=true&sender_filter=Alice&max_messages=0` --- ## About this tool Telegram Export Reader turns a Telegram Desktop machine-readable `result.json` export into plain text you can actually read: a dated transcript plus per-sender message counts, word counts, top words, top emoji and media/service-message counts. Paste the JSON export; everything runs locally in WebAssembly and no chat history is uploaded. It accepts the common Telegram Desktop shapes: - a single-chat export with a top-level `messages` array; - a full account export with `chats.list[].messages`; - a bare array of message objects. Formatted Telegram text arrays are flattened into normal text, while media-only messages become readable placeholders such as `[photo]`, `[sticker 🎉]`, `[voice message]` or `[file: invoice.pdf]`. ## Worked example Input: ```json { "name": "Weekend Trip", "type": "private_group", "messages": [ {"type":"message","date":"2021-03-27T14:45:00","from":"Alice","text":"Hey everyone ready for the trip"}, {"type":"message","date":"2021-03-28T09:46:10","from":"Bob","text":["Yes ",{"type":"bold","text":"so"}," excited 🎉"]}, {"type":"message","date":"2021-03-28T09:47:00","from":"Bob","text":"","photo":"photos/photo_1.jpg"} ] } ``` Output (`both` mode): ```text Chat: Weekend Trip (private group) Messages: 3 Participants: 2 Words: 9 Media messages: 1 Date range: 2021-03-27 to 2021-03-28 Messages per sender: 2 66.67% Bob (3 words) 1 33.33% Alice (6 words) Top words (min length 3): 1 everyone 1 excited 1 hey 1 ready 1 the 1 trip 1 yes Top emoji: 1 🎉 === Transcript === [2021-03-27 14:45:00] Alice: Hey everyone ready for the trip [2021-03-28 09:46:10] Bob: Yes so excited 🎉 [2021-03-28 09:47:00] Bob: [photo] ``` ## Options and limits - **Output**: `transcript`, `stats` or `both`. - **Include service messages** adds group-created, member-invited, title-changed and similar system lines to the transcript and service count. - **Sender filter** keeps only one display name, case-insensitively. - **Max messages** caps the rendered export after filters; use `0` for all. - The tool reads JSON only. Telegram's HTML export is not supported; export with **Format: Machine-readable JSON** in Telegram Desktop. - Media files are not embedded in `result.json`, so the tool reports placeholders instead of extracting photos, stickers or voice notes. ## FAQ
How do I get result.json from Telegram? In Telegram Desktop, open the chat menu, choose **Export chat history**, and set **Format** to **Machine-readable JSON**. Telegram writes a folder containing `result.json`; open that file in a text editor, copy all of it, and paste it here. For a full account export, use Settings → Advanced → Export Telegram data.
Does this upload my private messages? No. The parser is pure WebAssembly running in the browser tab. Your pasted JSON is not sent to a server, and the output is computed locally.
Why do I see [photo] or [sticker] instead of the media? Telegram's `result.json` references exported files by path; it does not contain the image, sticker, audio or document bytes. This tool reads the JSON only, so it keeps a clear placeholder in the transcript instead of trying to load files that were not pasted.
Can I analyze just one person? Yes. Put their Telegram display name in **Sender filter**. Matching is case-insensitive and exact after trimming, so `Bob` matches `bob` but not `Bobby`. The filter applies before the message cap.
What does the word count include? Words are split on whitespace for per-sender totals, while the "Top words" list uses alphanumeric tokens of at least three characters. Emoji are counted separately in the "Top emoji" list.
## Related tools - [Convert a Voice Note](https://gizza.ai/tools/voice-note-converter/): Convert WhatsApp, Telegram, Signal and other Opus/Ogg voice notes to MP3 or WAV, or encode audio back to Opus voice notes in your browser. - [Word Counter](https://gizza.ai/tools/word-count/): Count the words, characters, and lines in any block of text. Free, instant, runs entirely in your browser — no sign-up required. - [Avro to JSON Converter](https://gizza.ai/tools/avro-to-json/): Decode Apache Avro Object Container Files (.avro / OCF) to JSON, NDJSON, or the embedded schema — no .avsc needed, free and private in your browser. - [Bencode decoder](https://gizza.ai/tools/bencode-decoder/): Decode bencode (the BitTorrent / .torrent serialization format) into readable JSON, and re-encode JSON back into canonical bencode — in your browser. Nothing is uploaded. - [CAMT.053 Statement Parser](https://gizza.ai/tools/camt053-parse/): Parse a camt.053 (or camt.052/054) ISO 20022 bank statement XML into JSON or CSV in your browser: balances, dates, counterparties, references. No upload.