Snapchat Memories Keeper (SMK)

Process Snapchat Memories exports locally on your PC: extract bundled media, merge overlays, embed capture metadata (time + GPS where available), and browse results on a map.

What This App Does

• Imports Snapchat export ZIP files and reads memories_history.json
• Processes bundled exports (media files inside the ZIP) fully offline
• Detects real file type from content (not only extension)
• Merges Snapchat overlay filters into photos and videos when present
• Embeds metadata for supported formats:
  • Images: EXIF date + GPS (.jpg, .jpeg)
  • Video: QuickTime/MP4 tags (.mp4, .mov)
• Quarantines suspicious tiny or corrupt files
• Scans existing folders for extension/GPS analysis and an optional map view

Important Notes

• This project is not affiliated with Snap Inc.
• This app processes files locally on your machine - no uploads, no telemetry.
• Offline-first: memory processing needs no internet. The optional GPS map may load map tiles when you open File Checker.
• Bundled exports only: link-only exports (JSON with download URLs but no media in the ZIP) are not supported.
• Same-day photos are paired to JSON using ZIP entry timestamps Snapchat leaves on the files (videos use each file’s embedded capture time). Prefer processing from the original export ZIPs — copying/extracting in a way that resets file times can fall back to weaker ordering.
• Snapchat My Eyes Only content is not included in normal Memories export flow. Move content into Memories first if you need it included.

Platform Support

Platform	Status	Repository
Windows 10/11 (64-bit)	Official — built, tested, supported	This repo
macOS	Beta / untested — separate project	LasHSHS/SMK-macos
Linux	Beta / untested — separate project	LasHSHS/SMK-linux
iOS / Android	Not planned	—

macOS and Linux live in isolated repos so experiments there cannot break Windows. Those builds are not tested or confirmed by the maintainer — only a starting point for contributors. Prefer this Windows release for real use.

Contributing

Contributors are very welcome.

• Windows (this repo): bugs, performance, UX, docs
• macOS / Linux: work in SMK-macos / SMK-linux only

See CONTRIBUTING.md.

Quick Start (User)

Official release — no extra software needed

1. Download the installer or portable ZIP from Releases.
2. Open Snapchat Memories Keeper (SMK.exe).
3. Request your Snapchat data export (Memories + JSON). Steps are also in the app Guide / Help.
4. Select the export ZIP (or folder with all ZIP parts).
5. Click Start — processing runs locally on your PC.

No Python, pip, ffmpeg, or other tools required in the official Windows build.

Windows SmartScreen: Windows may warn that the app is unsigned. That is normal. Use More info → Run anyway if you got it from the GitHub release. Check the SHA-256 on the release page. Official builds stay on GitHub only (no Microsoft Store / no paid code signing).

Build & Release

See agent-docs/ALL_IN_ONE_PACKAGING.md for the canonical packaging rules (bundle everything; file size is not a concern).

See agent-docs/DISTRIBUTION_GUIDE.md for the release checklist.

powershell -ExecutionPolicy Bypass -File .\build_smk.ps1

Output: dist/smd/SMK.exe (all-in-one portable folder; package dir name stays smd).

Architecture

flowchart TD
    A[Export ZIP] --> B[GUI Import]
    B --> C[memories_history.json parser]
    C --> D[Bundled media extractor]
    D --> E[Overlay merge + metadata]
    E --> F[Final media library]
    F --> G[Scan and Map tools]

Loading

classDiagram
    class Memory {
      +date
      +download_link
      +media_download_url
      +location
      +latitude
      +longitude
      +filename
    }

    class LocalPipeline {
      +extract_zip_media()
      +match_json_rows()
      +merge_overlays()
      +apply_metadata()
    }

    class Metadata {
      +apply_metadata()
      +apply_video_metadata()
      +extract_gps_image()
      +extract_gps_video()
    }

    class DesktopGUI {
      +import_export_zip()
      +start_processing()
      +scan_folder()
      +show_map()
    }

    Memory --> LocalPipeline
    LocalPipeline --> Metadata
    DesktopGUI --> LocalPipeline
    DesktopGUI --> Metadata

Loading

Reliability Roadmap

• Phase A (stability hardening): crash fixes, path portability, skip/stat correctness, metadata flow integrity
• Phase B (safe UX improvements): clearer status/reporting, better issue summaries, beginner-first wording
• Phase C (visual polish): modern UI refinements after behavior is stable

Security & Trust Checklist (Release)

• Publish SHA-256 checksums for each release binary
• Say clearly if the build is unsigned (SmartScreen warning)
• Add clear "no telemetry" statement if you keep that policy
• Add license + trademark notice (name/logo usage policy)
• Code sign when a certificate is available (new release with signed files)