About

This is a simple tool for analyzing/parsing data from your Snapchat backup. To start, you'll need to download your saved Snapchat data:

https://support.snapchat.com/en-US/a/download-my-data

Currently, there's two main functionalities offered by this program.

Chat parsing

Snapchat stores your entire chat history in one file, chat_history.json. By using snapchat_chat_parser.py, you'll convert that file into a set of per-user json files, e.g. if your entire chat history contains messages between Alice, Bob, and Cody, running that script will produce the following files:

• messages-with-alice.json
• messages-with-bob.json
• messages-with-cody.json

Usage:

usage: snapchat_chat_parser.py [-h] -i INPUT_CHAT_HISTORY_JSON -y YEAR -o OUTPUT_DIR

options:
  -h, --help            show this help message and exit
  -i INPUT_CHAT_HISTORY_JSON, --input-chat-history-json INPUT_CHAT_HISTORY_JSON
                        The path to the `chat_history.json` file
  -y YEAR, --year YEAR  The year the snapchat dump was taken. Needed to determine format.
  -o OUTPUT_DIR, --output-dir OUTPUT_DIR
                        The output directory to put the JSON files

Map generation

Snapchat stores your whole location history in a timestamped format, e.g. a timestamp and coordinate (latitude/longitude) pair; this file is called location_history.json in the exported data.

Generating Folium interactive map from location history

snapchat_location_history_analyzer.py simply creates an interactive Folium map out of this data.

To use, run:

$ python3 snapchat_location_history_analyzer.py --input-file=location_history.json --output-file=<OUTPUT FILENAME HERE>

And then open the map.html that is created.

You'll see something that looks like this:

Generating GPX file from location history

snapchat_generate_gpx_from_location_history.py generates a GPX file of your location history, out of "waypoints". This allows you to use your own tools to visualize your location history.

To use, first install lxml, then run:

$ python3 snapchat_generate_gpx_from_location_history.py --input-file=location_history.json --output_file=<YOUR GPX FILENAME HERE>

Here's an example of what the resulting file looks like:

<?xml version="1.0" encoding="utf-8"?>
<gpx xmlns="http://www.topografix.com/GPX/1/1" version="1.1" creator="snapchat_generate_gpx_from_location_history.py">
  <metadata>
    <copyright author="Z390-AORUS-PRO-WIFI"/>
    <time>2023-05-07T15:58:55.056307</time>
    <keywords>https://github.com/raleighlittles/Snapchat-Chats-And-Location-Analyzer</keywords>
    <bounds minlat="32.703" minlon="-116.122" maxlat="37.947" maxlon="-120.515"/>
  </metadata>
  <wpt lat="34.207" lon="-118.429">
    <time>2022-08-07T20:11:19.000000</time>
    <cmt>Measurement 0 of 13262</cmt>
  </wpt>

Loading this into the GPX viewer of your choice:

For troubleshooting, I included the actual GPX XSD that you can use to verify the generated GPX.

$ xmllint --schema gpx.xsd <YOUR GPX FILENAME HERE> --noout