English | Français

Snapchat Memories Processor

Easily process all your exported Snapchat Memories while preserving overlays, timestamps and locations.

Snapchat exports Memories as raw media files and a separate metadata file. This tool reconstructs your memories by restoring overlays and optionally writing GPS information back into your photos and videos.

Table of Contents

• Export your Snapchat Memories
• Installation
• Requirements
  • FFmpeg
  • Optional: GPS Metadata Support
• Preparing Your Export
• Usage
  • Terminal User Interface (Recommended)
    • Running the application
  • Command Line (inside a terminal)
    • Basic Usage
    • Preserve GPS Metadata
    • Custom Worker Count
• Example Output
• Output Directory
• Error Logs
• License
• Contributing

Export your Snapchat Memories

This section will explain how to export your Snapchat Memories and metadata from Snapchat.

First, login to your snapchat account (phone or pc) and head to Settings -> My Data

You should then check Export your Memories AND Export JSON files.

After that you will be prompted to select the time range of the export, this is up to you.

Depending on the size of the export, you should pretty quickly receive an email from snapchat, saying that your export is ready. You can then head to the same page and you'll se the Your exports section. When unfolding it, you should see something similar to this:

Download all the zip archives and you'll be ready to start!

---

Installation

Download the latest release for your operating system from the Releases page.

Prebuilt binaries are available for:

• Windows
• macOS
• Linux

Note

No installation is required. Simply download the appropriate executable and place it wherever you want to use it.

---

Requirements

FFmpeg

FFmpeg is required for processing videos and overlays. If you don't have it installed, you can't use this tool

Windows

The easiest and fastest way to install it is running this command in a command line or powershell:

winget install ffmpeg

Warning

If winget is not recognized as a command, don't panic and install it via the Microsoft Store. Just search for "App Installer".

macOS

brew install ffmpeg

Linux

Ubuntu / Debian:

sudo apt install ffmpeg

Arch Linux:

sudo pacman -S ffmpeg

Verify the installation:

ffmpeg -version

---

Optional GPS Metadata Support

By default, GPS coordinates are not written back into the generated media files.

If you want to preserve location data, install ExifTool and use the --gps flag.

Windows

Again, the easiest way is to install it via winget, running this command:

winget install -e --id OliverBetz.ExifTool

macOS

brew install exiftool

Linux

Ubuntu / Debian:

sudo apt install libimage-exiftool-perl

Arch Linux:

sudo pacman -S perl-image-exiftool

Verify the installation:

exiftool -ver

---

Preparing Your Export

Place all Snapchat export ZIP files in a directory.

Example:

exports/
├── mydata.zip
├── mydata-2.zip
├── mydata-3.zip
└── mydata-4.zip

Note

The archives may be stored anywhere on your system.

---

Usage

To use this application, you currently have 2 options.

• The first one is using the Terminal User Interface (TUI) which is very simple even if you're not comfortable with command lines as it is a visual interface.
• The second is to use the Command Line Interface (CLI). It's also very easy but I would suggest you use the TUI if you don't want to write things in the terminal.

Regardless of your choice, the following parts explain how to use both :)

Terminal User Interface

A dedicated Terminal User Interface (TUI) is available and provides a much simpler and more user-friendly experience than the command line interface.

Download the dedicated smp-tui archive for your operating system from the Releases page.

Running the application

Windows

Double-click smp-tui.exe, or launch it from a terminal.

macOS

chmod +x smp-tui
./smp-tui

Linux

chmod +x smp-tui
./smp-tui

Important

FFmpeg is still required for processing videos and overlays.

If you enable GPS metadata preservation, ExifTool must also be installed on your system.

The application will report an error if one of the required dependencies is missing.

The TUI includes a built-in file browser, allowing you to launch the application from any directory on your computer.

Simply:

1. Launch the application.
2. Select the folder containing your Snapchat export archives.
3. Choose whether to preserve GPS metadata.
4. Adjust the worker count if needed.
5. Start the processing.

A live progress bar is displayed during processing, followed by a summary showing the number of successfully processed files, failures (if any), and the location of the generated output directory.

All processing options available in the CLI are also available in the TUI.

Command Line

Basic Usage

smp process -i ./exports

The -i flag specifies the directory containing your Snapchat export archives.

Preserve GPS Metadata

smp process -i ./exports --gps

Note

This requires ExifTool to be installed.

Custom Worker Count

smp process -i ./exports -w 8

The worker count controls how many files are processed simultaneously.

Tip

In most cases, the default value is sufficient.

---

Example Output

Total media  : 2502
Videos       : 1898
Images       : 604
With overlay : 435

Processed    : 2502
Failed       : 0

Completed in 42.7s

---

Output Directory

Processed media files are written to the output directory by default.

Example:

output/
├── 2020-07-24_094EC87A-main.jpg
├── 2020-07-24_42180C76-main.mp4
└── ...

---

Error Logs

If one or more files fail to process, an error log is generated automatically:

output/errors.log

This file contains detailed information about each failure and can be useful for troubleshooting.

License

This project is under MIT License

Contributing

Want to make this tool better ? Don't hesitate to open an issue or fork it and open a PR. I'll be happy to read it :)

Also if you enjoy the tool, leaving a ⭐ would be appreciated, thank you!

TUI built with bubbletea