SnapXO (Snapchat Export Organizer)

Snapchat hands you your data back as a jumbled mess of JSON, HTML and media files, with no structure whatsoever. SnapXO turns that into a well-organized folder you can actually use: your media sorted and dated, your chats readable again, your stats as charts, and a map of where it all happened. On top of that it builds you a proper UI for all of it, not just the media. It runs offline on your own machine and is useful across PC and Mobile.

pip install snapxo

Overview	Media
Chats	Snap Map

see more of the UI and files SnapXO generates here.

Features

index.html is the full archive of your Snapchat data export, packed with an Overview, your Stats, Media and Chats. It opens straight from disk, works without a server, offers user-friendly file names and folders, and works just as well on a phone as on a desktop. Natively.

Main features

• Chats: full chat history with images, voice messages, videos and snaps. searchable names and messages included.
• Media: A gallary of your Snapchat media, sorted and efficiently encoded, with type and yeaar filters, and a details panel per file.
• Stats: Your Snapchat statistics neatly formatet and illustratet with charts.
• Overview: one familiar interface; Organized, backwards-compatible and user-friendly, out of the box

Other features

• Media organization: memories and chat media in structured folders with clean filenames (2026-05-08_0444.mp4)
• Snap Map: see where you took your snaps on the globe.
• Location visuualisation: see where you've been. (even comes with an animation)
• Charts: Statistical Charts for:
  • messages
  • chat media
  • snaps
  • friends
  • story views over time
  • activity by time of day
  • activity by weekday
  • type distribution
  • who writes you most
  • etc.
• Interactive Use of SnapXO: snapxo -i walks you through the enitre tool instead of crafting a command.
• PDF: snapxo pdf, media, chats, stats baked right into a PDF file, ready to print or save
• Spreadsheets: your stats as XLSX, ODS or CSV, the XLSX with real Excel charts you can edit
• Self-hosting: a docker compose file that hosts the archive on your own network. Got a Raspberry Pi or a home server? Run it there and browse your archive comfortably from your phone or other devices.
• Verify: for data integrity and to catch data corruption early
• Rebuild: backwards-compatible and idempotent. Bring an older archive up to date, or just regenerate it (without needing the original export ZIP)
• Merge: Merge several exports into one, deduplicated and renumbered
• Duplicate removal: MD5 deduplication, before encoding (storage and time efficient)
• H.265 encoding: Intel QSV hardware acceleration, automatic fallback to libx265
• Overlay burning: Snapchat overlays burned onto photos and videos
• GPS/EXIF: coordinates from memories_history.json written into image EXIF
• Voice messages: audio-only MP4s detected and converted to MP3
• Timezone: --timezone Europe/Vienna converts every timestamp out of UTC, so your numbers reflect the timezone you actually lived in

Runs on Windows, Linux and macOS,
with a UI that works the same on desktop and mobile.

Installation

pip install snapxo

snapxo doctor tells you if external tools are missing and prints the install command for the system you are on.

For video processing: ffmpeg and ffprobe are native programs, so pip cannot install them.

You can also use pip install "snapxo[ffmpeg]", which brings both binaries along, but those have no hardware encoding. A system-wide ffmpeg is recommended.

For snapxo pdf on the command line only:
playwright install chromium downloads the browser that renders the PDFs. This only applies if you export PDFs through the CLI. On Linux it may also need playwright install-deps chromium.
PDFs can still be exported through the UI without installing any of this.
The export buttons build their files in the browser you already have. SnapXO loses nothing by skipping this step; it only affects snapxo pdf.

Quick start

1. Ask Snapchat for your data at accounts.snapchat.com, then download the ZIP it mails you
2. snapxo organize mydata.zip -o ./my-archive -y
3. Open my-archive/index.html, or just explore the folder yourself

That is the whole tool. Everything below is optional, extra features that build on the archive organize just made.

# Several ZIPs, or a whole folder of them
snapxo organize export1.zip export2.zip -o ./my-archive -y
snapxo organize ~/Downloads -o ./my-archive -y

# Look before you write
snapxo info mydata.zip
snapxo organize mydata.zip --dry-run

ARCHIVE means a folder SnapXO already organized.

Four more commands exist:

• html: writes the one page per topic versions
• merge: merges several archives into one
• verify: checks an archive against its manifest
• doctor: checks your tools.

Running from a clone? Every command works the same as python -m snapxo ..., so nothing has to be installed:

python -m snapxo organize mydata.zip -o ./my-archive -y

See DOCUMENTATION.md for the full feature list, every command and every flag.

Output Structure

output/
├── 2022/                    folders with organized media
├── ...
├── 2026/
│   ├── 2026-05-08_0444.mp4  H.265 encoded, with EXIF/GPS
│   ├── 2026-05-08_0445.jpg
│   └── 2026-05-08_0446.mp3
├── _overlays/               Overlays that matched no media
├── _meta/                   Raw JSON + HTML from export
│   ├── manifest.json        What each file is and where it came from
│   ├── checksums.json       Fingerprint for `snapxo verify`
│   ├── integrity.json       Files that arrived damaged, if any
│   ├── app-chats.js         Every chat and message, for the Chats tab
│   ├── app-media.js         Every file and its details, for the Media tab
│   ├── app-stats.js         The numbers behind the charts, for the export buttons
│   ├── thumbs/              Preview images for the gallery and the chats
│   │   └── medium/          Larger copies, written by `snapxo pdf` only
│   ├── json/
│   └── html/
├── index.html               The archive: Overview, Stats, Media, Chats
└── map.html                 Interactive Snap Map

The other commands add to it:

Flags

The most-used ones. The full list for every command is in DOCUMENTATION.md.

--no-meta is permanent. rebuild and merge won't work on that folder again, ever. You've been warned.

Privacy

SnapXO runs entirely on your machine, on files you downloaded yourself and handed to the tool. It makes no network requests, never logs into an account and never contacts Snapchat.

Two things are worth knowing:

• map.html loads its map library and its map tiles from the internet when you open it. That has nothing to do with SnapXO's own functionality. Its purely how the map draws itself and its UI elements. Generating the page does not touch the network at all; every other page works with none.
• snapxo docker serves your archive on your home network, which is what makes it reachable from your phone. Set a password, and do not forward the port through your router.

The browser Chromium that snapxo pdf uses is put into offline mode, so it cannot reach the network even if a page asked it to. This only applies to the CLI's pdf command, nothing else in SnapXO touches a browser.

Disclaimer

Not affiliated with Snap Inc.
This is an independent, unofficial open-source tool. It is not created, endorsed, sponsored or supported by Snap Inc., and has no connection to Snapchat, Snap Inc. or any of its products. "Snapchat" and "Snap" are trademarks of Snap Inc., used here only to describe what this tool reads. SnapXO works purely offline on a data export you requested and downloaded yourself. This tool never logs into an account and never contacts Snapchat.

Credits

SnapXO couldn't have been built without these tools: click, rich, Pillow, Leaflet, Lucide and more. Every one of them, what it is used for and the licence it comes under, is listed in THIRD-PARTY-NOTICES.md.

License

GPL-3.0