Skip to content

A modern, fast, and privacy-focused viewer for your Snapchat message data exports.

Notifications You must be signed in to change notification settings

rayanical/snapchat-viewer

Repository files navigation

👻 Snapchat Data Viewer

A modern, fast, and privacy-focused viewer for your Snapchat data exports. Browse your chat history, search messages, and view media files directly in your browser without uploading any data to a server.

✨ Features

  • 🔒 Privacy First: Zero data collection. All processing happens locally in your browser. No servers, no tracking.
  • ⚡ High Performance: Built with React and optimized with react-virtuoso to handle massive chat logs (100k+ messages) with 60fps scrolling.
  • 🔍 Full-Text Search: Instant client-side search powered by FlexSearch to find specific messages across all conversations.
  • 📸 Media Support: Automatically resolves and displays local photos and videos from your data export (images/videos must be in the chat_media folder).

🚀 Usage

1. Get your Data

  1. Go to Snapchat Accounts and login.
  2. Select My Data.
  3. Request a download (ensure "Chat History" and "Memories" are selected).
  4. Download and unzip the my_data.zip file when it's ready.

2. Run the Viewer

You can run this project locally:

# Install dependencies
npm install

# Start development server
npm run dev

3. Load Data

  1. Open the app in your browser (usually http://localhost:5173).
  2. Drag and drop your entire unzipped folder (e.g., my_data_1234) onto the drop zone.
    • Alternatively, select the json/chat_history.json file manually.
  3. The app will parse your history and build a search index in seconds.

🛠 Tech Stack

📂 Project Structure

src/
├── components/     # UI Components (Chat, Sidebar, etc.)
├── hooks/          # Custom hooks (File handling, Media resolution)
├── stores/         # State management (Conversation, Search, Media)
├── utils/          # Parsers and helpers
└── types/          # TypeScript definitions

⚠️ Disclaimer

This project is an independent tool and is not affiliated with, endorsed by, or connected to Snapchat Inc. It is open-source software designed for personal data viewing.

📄 License

MIT

About

A modern, fast, and privacy-focused viewer for your Snapchat message data exports.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages