Year-End Replay 📊

Transform your digital year into beautiful Apple-inspired visualizations! Upload your data exports from YouTube, Yelp, Twitter, and Reddit to create stunning year-end summaries similar to Spotify Wrapped.

✨ Features

• Multi-Platform Support: YouTube, Yelp, Twitter, Reddit (Instagram & TikTok coming soon)
• Apple-Inspired Design: Clean, minimalist aesthetic with light/dark mode
• Privacy-First: Data processed locally, never permanently stored
• Beautiful Visualizations: Interactive charts and shareable social cards
• Instant Insights: Discover surprising patterns in your digital behavior

🚀 Quick Start

1. Upload Your Data: Export your data from supported platforms
2. Get Insights: View beautiful analytics and charts
3. Share Your Story: Download images or share links with friends
4. Stay Private: Delete your data anytime with one click

📱 Supported Platforms

Current (Phase 1)

• YouTube: Watch history, top channels, viewing patterns
• Yelp: Review history, ratings, business categories
• Twitter: Tweet patterns, hashtags, mentions, engagement
• Reddit: Posts, comments, subreddits, karma distribution

Coming Soon (Phase 2)

• Instagram: Stories, posts, interactions
• TikTok: Watch time, favorite creators, trending content

🛠️ Tech Stack

• Backend: Flask, SQLAlchemy, PostgreSQL
• Frontend: Apple-inspired CSS, Chart.js, Bootstrap 5
• Data Processing: Python, JSON/CSV parsers
• Deployment: Replit, Gunicorn

📊 Data Export Instructions

YouTube

1. Go to Google Takeout
2. Select "YouTube and YouTube Music"
3. Choose "My Activity" → Download JSON

Yelp

1. Visit Yelp Account Settings
2. Go to "Privacy" → "Request Account Data"
3. Download when ready

Twitter

1. Go to Twitter Settings
2. Request your archive
3. Upload the JSON files

Reddit

1. Visit Reddit Privacy Settings
2. Request your data
3. Upload the JSON export

🔒 Privacy & Security

• No Cloud Storage: Data processed on our servers, not stored permanently
• User Control: Delete all your data with one click
• Session-Based: No accounts required, temporary sessions only
• Secure Processing: Files validated and processed securely

🎨 Design Philosophy

Inspired by Apple's design principles:

• Clarity: Clean, easy-to-understand visualizations
• Simplicity: Minimal interface, maximum impact
• Accessibility: Light/dark mode, responsive design
• Privacy: User control over their data

🚀 Getting Started (Development)

# Clone the repository
git clone <your-repo-url>
cd year-end-replay

# Install dependencies
pip install -r requirements.txt

# Set up environment variables
export DATABASE_URL="your-database-url"
export SESSION_SECRET="your-secret-key"

# Run the application
python main.py

📈 Roadmap

• YouTube & Yelp support
• Twitter & Reddit integration
• Apple-inspired design
• Light/dark mode toggle
• Privacy features
• Instagram support (Phase 2)
• TikTok integration (Phase 2)
• Advanced sharing features
• Premium analytics tier

🤝 Contributing

We welcome contributions! Please feel free to submit issues and enhancement requests.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🎯 Vision

Making digital self-reflection accessible and beautiful. Everyone deserves to see their digital story told in a meaningful way.

---

Built with ❤️ for digital storytelling