GUIDEWhat is inside a Snapchat data export

Your Snapchat chats, readable again.

A Snapchat data export gives you chat_history.json and a chat_media folder with thousands of files whose names say nothing. ThreadTidy matches each file to its message and gives you one page per conversation, with the photos, videos and voice notes in place, right in your browser.

  • Nothing uploaded, ever
  • No Python, no Docker, no install
  • Your original export is not changed

At a glance

What ThreadTidy does and doesn’t do

  • Works withThe mydata ZIP files of a Snapchat “My Data” export that includes chat_history.json and chat_media. One ZIP or several parts, as downloaded.
  • ProducesOne HTML page and one text file per conversation, an index with search and counts, media renamed by date and friend, and messages.csv. All in one ZIP.
  • Runs onAny browser: Windows, Mac, iPhone, Android. Nothing to install. No Python or Docker.
  • Free2 full conversations + the full list. Full: $9 one-time, every conversation.
  • PrivacyYour files never leave your browser. Nothing is uploaded.
  • Doesn’tShow chats Snapchat did not export: only saved chats are in the export. It does not recreate media that is missing from the export, and it does not touch Memories.
The result opens in
  • Chrome
  • Safari
  • Edge
  • Firefox
  • Excel
  • Any text editor
1 page

per conversation: one friend or one group, in order

How it works
0 bytes

of your chats sent to any server

Privacy
2

full conversations free, plus the list of all of them

Try it
$9

once, every conversation, no subscription

Pricing

The problem

You downloaded your chats. You can’t read them.

The export is free and it is your data. But what arrives is a data file and a folder of loose media.

Your chats are one JSON file

Every message of every friend sits in chat_history.json: sender, time, text and a list of media IDs. It is made for programs, not for reading.

Media with unreadable names

Photos, videos and voice notes are all in chat_media, named like 2024-03-14_b~EiQSFT….jpg. The name does not say who sent it or in which chat.

The usual fix needs a computer

The tools people recommend are a Python package and a Docker project. Both need a computer and a command line. Uploading private chats to a website is not a good idea either.

How it works

Three steps. No unzipping, no command line.

  1. Step 1

    Request your export with chats

    In Snapchat: Settings → My Data. Turn on Export JSON Files, Chat History and chat media. Step-by-step guide

  2. Step 2

    Drop the ZIP files here

    All parts at once, as downloaded. ThreadTidy reads chat_history.json and matches the media files to the messages by their Media IDs.

  3. Step 3

    Download and open index.html

    One new ZIP: a page per conversation with photos, videos and voice notes in order, a search box, a text copy of each chat and messages.csv.

Open export

Open your Snapchat export

Everything runs on this page. Your chats never leave your device.

Drop your Snapchat mydata .zip files here

All parts at once, as downloaded. The export must include chat history and JSON files. Nothing is uploaded.

Free: your 2 longest conversations in full, and the list of all of them. Unlock every conversation for $9.

Plain files

Pages you can keep, with no app behind them.

The result is ordinary HTML, text, CSV and your own media files. It opens in any browser, works offline and loads nothing from the internet.

  • One folder per conversationThe page, a text copy and the media of that chat, renamed with date, time and the friend’s name.
  • index.html with searchEvery conversation with its message and media counts. Search names and message text.
  • messages.csvOne row per message: conversation, time, sender, text, Media IDs, the matched files and their status.
The ZIP you get back
index.html          all conversations + search
messages.csv
Alice/
  Alice.html   Alice.txt
  2024-03-14_1531_Alice_1.jpg
  2024-03-14_1532_Alice_2.mp4
Weekend-Plans/
  Weekend-Plans.html   Weekend-Plans.txt
messages.csv
Conversation, Created (UTC), From, Content, Media files, Media status
Alice, 2024-03-14 15:31:00, alice.w, look at this, Alice/2024-03-14_1531_Alice_1.jpg, ok
Alice, 2024-03-14 15:33:00, me, , , media not included in the export

What you get back

Every conversation the way you remember it, with the media where it was sent.

ThreadTidy reads chat_history.json and matches the media files with the messages. It tells you what Snapchat did not include instead of hiding it.

One conversation per friend

Each friend and each group chat gets its own page: bubbles, who said it, date and time, oldest first.

Photos, videos and voice notes in order

Media appear inside the conversation, at the message they were sent with. Not in a separate folder you have to guess from.

Search

The index page searches friend names and message text, and jumps to the message in its conversation.

Works offline, nothing uploaded

There is no upload step. Your chats are read in this browser tab only, and the pages you get need no connection.

Honest about what is missing

Only saved chats are in a Snapchat export. Media that the JSON names but the export lacks is marked “media not included in the export”. It cannot be recreated.

Text and CSV too

A plain text copy of every conversation and one messages.csv for spreadsheets. Media renamed like 2024-03-14_1531_Alice_1.jpg.

Compared

Three ways to deal with the export.

FeatureThreadTidyPython or Docker toolsRaw export
CostFree for 2 conversations, $9 once for allFreeFree
What you installNothingPython or Docker, on a computerNothing
Where it runsIn the browser, phone or computerOn a computer, from a command line—
Media matched to messagesYes, by Media IDDepends on the toolNo: IDs in the JSON, files in one folder
Files leave your deviceNeverNever—

Pricing

Free for 2 conversations. $9 once for all of them.

Start free

Free

$0

See every conversation in your export with its counts, and read your 2 longest ones in full.

Read my chats
  • The full list: messages and media per conversation
  • 2 full conversations, media in place
  • Search, text copies and messages.csv for those 2
  • No account

ONE-TIME

ThreadTidy Full

$9 USD

one-time · every conversation · any number of exports

Unlock every conversation, $9
  • Every conversation in the export
  • Multi-part ZIP exports
  • Unmatched media kept in its own folder
  • No subscription
Secure checkout by Stripe. The full version unlocks in the browser you pay from. Questions: support@cedanolabs.org.

FAQ

Questions about the Snapchat chat export

Want the long version? Read the guide.

Read the guide
What does ThreadTidy do with my Snapchat export?

It reads chat_history.json from your Snapchat "My Data" export and matches each message to its files in the chat_media folder. You get a ZIP with one HTML page per conversation (bubbles, who said it, date and time, photos, videos and voice notes in place and in order), an index page with search, a plain text copy of every conversation, the media renamed by date and friend, and messages.csv.

Are my chats uploaded anywhere?

No. The ZIP files are read and the new ZIP is built by JavaScript on this page, on your device. There is no upload step. Once the page has loaded it needs no connection to read your export. The only network requests are for the page itself, cookieless page analytics, and the payment check if you buy the full version, which sends a payment ID and never a file.

Do I need Python, Docker or a command line?

No. There is nothing to install. You open this page in a current browser on Windows, Mac, iPhone or Android and choose the ZIP files.

Why are some of my chats missing?

Snapchat only exports what it still has on its servers. In practice that is the messages you or your friend saved in the chat, and the media saved in chat. Messages that were never saved were deleted by Snapchat after they were viewed or expired, so they are not in the export, and no tool can bring them back.

Why do some messages say "media not included in the export"?

chat_history.json names a media file for that message, but the file is not in the ZIP files you dropped. First check that you dropped every part of the export together. If you did, Snapchat did not export that file. ThreadTidy marks the spot and does not invent or recreate media.

How are photos and videos matched to messages?

Each message in chat_history.json lists its "Media IDs". The files in chat_media are named with the date and that same ID, for example 2024-03-14_b~EiQSFT….jpg. ThreadTidy matches them exactly by ID. A file that no message names is attached only when the time stored for it in the ZIP is the same second as a media message that has nothing attached; messages.csv says "matched by timestamp" for those. Everything else is listed as unmatched.

Snapchat gave me several ZIP files. What do I do?

Drop all of them at once, as downloaded, without unzipping. The JSON is in one part and the media can be in others. ThreadTidy reads every part together.

How do I get an export that includes chats and media?

In Snapchat, open Settings, then My Data. Turn on "Export JSON Files", "Chat History" and the option to export chat media, set the date range to all time, and submit. Snapchat emails you a link to one or more mydata ZIP files. The guide has the steps.

What is in the ZIP I get back?

index.html (the list of conversations with message and media counts, and a search box), one folder per conversation with its HTML page, a .txt copy and its media renamed like 2024-03-14_1531_Alice_1.jpg, and messages.csv with every message. In the full version, files in chat_media that matched no message go to an unmatched-media folder. The pages work offline and load nothing from the internet.

Is there a size limit?

The new ZIP can hold up to 4 GB and 65,535 files. Media are copied straight from your export without being loaded into memory, so normal exports work. If your chat media pass 4 GB, the media that do not fit are marked as not copied in the pages and in messages.csv. Very large exports are best done on a computer.

Which time zone do the times use?

UTC, the same as Snapchat writes in chat_history.json. The pages say so at the top of every conversation.

Does it fix my Snapchat Memories?

No. ThreadTidy only reads chats. For Memories (wrong dates, overlay files), use Restamp at restamp.fyi, a separate tool from the same maker.

Does it change my original export?

No. It only reads the ZIP files you choose and gives you a new ZIP.

How does the $9 full version work?

Free shows the full list of your conversations with counts and gives you the 2 longest ones in full. The full version is a single $9 payment, with no subscription and no account, and includes every conversation, in any number of exports. It unlocks in the browser you pay from.

Read your chats the way they happened.

Drop the ZIP files from Snapchat and get a page per conversation. The first 2 are free.