Snapchat memories downloader

Bulk download of all your Snapchat memories and associated metadata (date/time and GPS coordinates).

Requirements

This project was build using Python 3.12.6, and may/will not work on previous versions of Python.

Instructions

Prepare your environment by downloading/cloning this project. Then go to its root directory and run:

python -m venv venv
source venv/bin/activate
pip install --upgrade pip
pip install -r requirements.txt

On Snapchat for web, go to Account parameters > My data, then ask for a data export, by specifying the following parameters:

Wait for the data export creation, then download it. You should have a JSON file called something like memories_history.json.

Go back to the root of this project and run:

source venv/bin/activate
python -m src.main path/to/your/memories_history.json

Optional

If you also want overlay on the top of your memories (i.e. captions, smileys, location, etc.), you can also ask for their export:

Wait for the data export creation, then download it. Within the archive, you should have a directory called something like memories. This directory contains your memories. File names that contain overlay are the overlays.

Go back to the root of this project and run:

source venv/bin/activate
python -m src.main path/to/your/memories_history.json --overlay_dir path/to/your/memories_dir

Information

Added metadata are date/time and GPS coordinates. Date time information is computed based on the given UTC timestamp, and the timezone of your computer. The metadata encryption was tested for Apple Photos and may not work for other photo libraries.