Telegram Export Viewer
Drop in result.json from your Telegram export (or the export folder zipped up) and read your chats the way they looked in the app, with one search box that covers all of them. The file never leaves your computer.
Telegram Export Viewer
Open the result.json from a Telegram Desktop export in your browser. Search every chat at once, read any thread with replies and forwards, and save a chat as TXT or CSV. Nothing is uploaded.
Drop your file here or click to browse
result.json or a .zip of the export folder
Reading your export...
Could not open this file
Pick a chat on the left, or type in the search box to look through all of them at once.
What a Telegram export actually gives you
Telegram Desktop can export your whole account. It's tucked away under Settings, Advanced, Export Telegram data, and it lets you choose what goes in: personal chats, groups, channels, photos, videos, voice messages. Right at the bottom of that dialog there's a format setting, and most people leave it on HTML because that's the default. What you get is a folder of messages.html, messages2.html, messages3.html and so on for every chat, each page holding roughly a thousand messages. It looks like Telegram. It's also nearly useless when you're trying to find something, because Ctrl+F only searches the page you have open, and a busy group can be spread over eighty of them.
Switch the format to Machine-readable JSON and you get one file called result.json instead. Everything is in there: every chat you ticked, every message, who sent it and when, what it was replying to, where it was forwarded from, and which file was attached. That's the file this viewer reads, and it's a far better source than the HTML once you have something that can open it.
What the viewer does with result.json
If some of your conversations live on WhatsApp instead, the WhatsApp chat analyzer reads its exported .txt file the same way, in the browser.
Drop the file in, or zip up the export folder and drop the zip, and your chats appear in a list on the left with their type, message count and the date of the last message. Click one and the messages show up in order with sender names, timestamps, an edited marker where someone changed their mind, and a quoted preview of whatever a reply was answering. Forwarded messages say where they came from. Service events, the grey lines like someone changing the group name or pinning a message, are shown as grey lines just like in the app.
- Search covers every chat at once, not only the one you're reading. Type a word and you get the number of matches, how many chats they're spread across, and a list of the actual messages with the hits highlighted. Click a result and the chat opens on the right page with that message outlined.
- Filter the chat list to people, groups, channels or bots. Useful when a full export has four hundred chats and you only care about two of them.
- Photos, videos, voice messages, stickers, files, contacts, locations and polls each get a labelled line with the file name from the export, so you can tell which file in the photos or files folder belongs to which message. Polls show the question, every answer and its vote count.
- If you exported without media, Telegram writes a placeholder where the file name should be. The viewer says file not included in the export instead of pretending there's a broken link.
- Save the open chat as plain text or as CSV. The CSV has one row per message with the date, sender, text, forward source, reply id and attachments, and it opens in Excel with accents and emoji intact.
Two kinds of file, both handled
To look at the raw structure of a small export, paste it into the JSON formatter and expand the chats list.
There are actually two shapes of result.json, and plenty of scripts on GitHub only cope with one. A full account export wraps everything in a chats object with a list inside, plus a separate list for chats you've left. A single chat export, the one you get from the three dots menu inside a chat, puts that one chat at the top level with its messages right there. The viewer works out which one it's been given and says so in the stats bar. Chats you've left are included and marked as left, because sometimes that's exactly the group you were looking for.
Message text comes in two shapes too. A plain message is stored as a simple string. Anything with bold, a link, a mention or a hashtag gets chopped into an array of pieces, some plain strings and some little objects with a type and the text. If you've ever opened result.json in Notepad and wondered why sentences look broken up, that's why. The viewer stitches the pieces back together so you read each message the way it was sent, and search works across the joins.
Your messages stay on your computer
I built this to run entirely in the browser because a Telegram export is about as private as data gets. It holds your conversations, your contacts' names, and very often addresses, card numbers and passwords that someone sent once and forgot about. The file is read by JavaScript in this tab and that's the end of the story. There's no upload, no account and nothing saved. Every message is also displayed as plain text, so if a friend once sent you HTML or a script tag as a joke, you'll see the characters on screen and nothing will run.
There is one limit, and it belongs to the browser rather than to this page. A JSON file has to be held in memory as a single block of text, and browsers start refusing somewhere around 500 MB. Text alone rarely gets that large, even for heavy users, because photos and videos are stored as separate files next to result.json. If yours does cross the line, export your biggest groups one at a time from the chat menu and open them separately.
How to get the JSON export
- Install Telegram Desktop on Windows, macOS or Linux. The phone apps can't export a whole account.
- Open Settings, then Advanced, then Export Telegram data.
- Tick the kinds of chat you want. Untick photos and videos if you only care about the text, since the export finishes far quicker that way.
- At the bottom, change the format to Machine-readable JSON.
- Click Export. The first time, Telegram may ask you to approve it from another device and make you wait up to 24 hours. That's a security check on their side, not a fault.
- When it's done, open the export folder and drop
result.jsonhere.
Who actually uses this
A chat saved as CSV can be sorted and filtered in the CSV viewer without opening Excel at all.
People leaving Telegram who want their history somewhere readable before they delete the app. Small business owners who ran orders through a group chat and now need to check what a customer agreed to back in April. Researchers and journalists working through public channels with thousands of posts. Parents or lawyers who've been handed a chat log and need to read it carefully, with dates. And honestly, a lot of people who just want to find that one link a friend dropped in a group two years ago. I'd bet that last one covers most visitors.
What it won't do
It doesn't show the photos themselves. The JSON holds file paths, not pictures, and matching them back up would mean loading your entire media folder into the page, which is slow and rarely what people want. It doesn't open the HTML export either, so if you already exported in HTML you'll need to run the export again with JSON picked. And it can't bring back messages that were deleted before you exported. If they weren't in Telegram on the day, they aren't in the file.
Got a ChatGPT data export sitting in your downloads too? The ChatGPT export viewer opens conversations.json the same private way.