What is in the attachments folder of a text-message export?

Short answer

The export folder holds the PDF, a copy of every original attachment that was in the conversation and the manifest that lists each file with its hash. Match an attachment to the PDF by the file name shown at the point where it was sent, and keep the whole folder together when you copy, send or archive it.

TextExhibit PDF page with two photos shown in place, each with file name, size and SHA-256 hash, and a reply quoting the message it answers
Photos in place with file name, size and hash, and a reply that quotes its message. From an export of made-up sample messages.

What you will find

  • The PDF (and the CSV or HTML if you chose them).
  • A folder of original attachments: photos, videos, voice messages, contact cards, documents.
  • The manifest: each file with a SHA-256 hash.

Matching a file to a message

  1. In the PDF, find the message with the attachment. The line names the file.
  2. Open the attachments folder and search for that name.
  3. Open the file. Photos open in Preview, videos in QuickTime Player, documents in their usual apps.
  4. If you refer to it elsewhere, cite the PDF page and the file name together.

Keeping things together

Moving the PDF alone leaves the attachments behind. Zip the whole folder before emailing or uploading, or copy it as a whole to a drive. See file size of exports if it is too large, and archiving to an external drive.

Privacy

Attachments can hold more than you expect: faces, documents, addresses, other people's details. Before sharing the folder with anyone other than a lawyer, look through it, and consider whether the PDF alone is enough.

Spot-checking a few files

Open the folder and open three files: the oldest, a mid-thread one and the newest. Check that photos open, audio plays and documents read. If a file will not open, check the manifest for it and try another viewer. A quick look now means no surprises when someone else opens the folder, and you can note in your own log which files you checked and on what date.

What to keep in mind

  • An attachment that was not stored on the phone or backup, for example one that was removed to save space, cannot be copied.
  • Do not rename or edit files in the folder. The hashes will no longer match.

Questions

Can I delete files I do not need?

Do that in a copy, not in the original export folder.

Are photos in the PDF and in the folder?

Yes, inline in the PDF and as originals in the folder.

What if two attachments have the same name?

Check the manifest and the PDF line for the exact file.

What if a file is zero bytes?

It may not have been downloaded. See the missing photos page.

Can I preview the folder in Finder?

Use Quick Look with the space bar.

Export the whole conversation

TextExhibit turns a conversation into one PDF with exact times, names and numbers, photos in place and page numbers, on your Mac. Free to preview; $24.99 once to export.