Adds metadata (captions and timestamps) to your exported Snapchat memories.
Snapchat allows you to save images/videos to their servers with their memories feature. When you export your memories from Snapchat from their accounts website, you get all the memories, but with no metadata and the captions are stored separately!
Base Image | Overlay Image |
---|---|
You may then go to an alternate project like ToTheMax's
Snapchat-All-Memories-Downloader,
which is fantastic! It uses a memories_history.json
file to download all memories and add a timestamp, but this technique loses all the captions! They aren't included in memories_history.json
:(
{
"Date": "2020-01-02 23:08:19 UTC",
"Media Type": "Image",
"Location": "Latitude, Longitude: 0.0, 0.0",
"Download Link": "https://app.snapchat.com/dmd/memories?..."
}
So in short, memories_history.json
has all the metadata we need, but we need
to combine it with the full memory export if we want captions. So this project
serves as a bridge between these two methods! We have all the metadata and we
have all the memory photos/videos and captions, we just need to combine them. The final result:
Note the caption is on the image, the file name and metadata has a timestamp! The file's creation date is also set to the correct date.
[!NOTE]
This project and documentation is not very friendly to non-developers :( If you have questions, I'm happy to try and help if you make a new Github issue. I'm very open to any PRs that want to work on making this more user-friendly (see the Contribution section below!)
This project relies on two major libraries.
ffmpeg@6
from
brew, and if you're on
Windows, install it from
[winget](https://learn.microsoft.com/en-us/windows/package-manager/ winget/)
with winget install -e --id Gyan.FFmpeg --version 6.0
(package
here).
scale2ref
filter, please see #7 for more
information. I plan on fixing this once ffmpeg 7 is available in Fedora
Linux.Finally, this project requires Python to be installed on your computer. Once installed, you can clone this repo and run
python -m pip install -r requirements.txt
to install the Python requirements for the project.
[!NOTE]
This project and documentation is not very friendly to non-developers :( If you have questions, I'm happy to try and help if you make a new Github issue. I'm very open to any PRs that want to work on making this more user-friendly (see the Contribution section below!)
First, we need to get our data. Follow Snapchat's instructions to download your data. You'll need to do two separate exports:
Check "Include your Memories, Chat Media and Shared Stories" to download all
your memories. (Note: this may take up a significant amount of space!) The
status of the other checkmarks shouldn't matter, so feel free to export any
additional data you'd like. Make sure the date range includes everything you
want to export! If you choose to download multiple data packages, merge all
the memories
folders into one memories
folder. This is the only folder you
need from the export for this script.
Create a second export, without "Include your Memories, Chat Media and
Shared Stories" checked, and with "Export JSON files" and "Memories and
Other Media" checked. Use the same date range as your first export. This
export should take much less time for Snapchat to send to you :) In this
data export, make sure you have a json/memories_history.json
. This is the
metadata for the memories, which is only generated when you don't export
your memories.
Now, make a folder in this repo called input
and put the memories
folder
from the first export and the memories_history.json
file from the second
export into it.
memories_history.json
file with the --memories-history
flag and the memories folder with the
memories
flag, for example python main.py --memories-history test/memories_history.json --memories-folder test/memories --output test_output
.With this folder prepared, you can now run python main.py
to run the script!
It will create a new folder called output
that will hold all memories with
timestamps and captions. (Note: this will create a new copy of each photo/video,
so make sure you have enough space!) Alternatively, use the --output
flag to
provide a different location to dump the photos.
If you run into issues, please run the script with the -v
or --verbose
flag, which will output information on what the script is doing. If that
doesn't help you with the issue, open a github issue with that output! You
can also use the -vv
flag to get logs from ffmpeg/vips.
Some other flags:
--image-only
will only convert images and not videos!--video-only
will only convert videos and not images!--only-one
will only convert one video and one image - useful for debugging
to see the log of only one conversion, or testing the script before running
it on your entire library.[!WARNING] If your captions are important to you, double check the final result against the photos in the Snapchat app! I found that the memories export did not include overlays/captions from some of my photos in 2017-2018. So check the final photos to make sure captions are there. If they aren't, you may need to download those impacted photos/videos directly from the Snapchat app. The majority of photos were successfully exported with all their captions.
Note: The timezone applied to the photos is set by your computer's local
timezone! I'm open to any PRs to improve this (see below), but for a quick
hack you can set the default timezone in SnapchatMemoriesCaptionAdder/adder.py
in the add_metadata
signature.
This achieved what I needed it to do, so I don't anticipate adding many more features. I'd be happy to accept PRs for some feaures I didn't implement:
MIT