🎬 IMDb Watchlist Picker

Can't decide what to watch? Upload your IMDb watchlist and let this app pick random movies for you!

✨ Features

• 🎲 Random Movie Picker - Get random suggestions from your watchlist
• 📊 Rich Movie Details - Ratings, cast, director, trailers, runtime
• 🔍 Smart Filters - Filter by genre, year, runtime
• ⭐ Favorites System - Mark movies you love
• ✅ Watch Tracking - Mark movies as watched
• 📜 History - View recently picked movies
• ⌨️ Keyboard Shortcuts - Navigate quickly with hotkeys
• 📱 Touch Gestures - Swipe to pick another movie
• 🌙 Dark Mode - Easy on the eyes
• ♿ Accessible - WCAG compliant, screen reader friendly
• 🔗 Platform Links - Quick access to IMDb, TMDB, Letterboxd, RT, Metacritic
• 🎬 Stremio Integration - One-click open in Stremio

🎨 Design

This app uses a neo-brutalist design system featuring:

• Bold orange (#FF6B35) and yellow (#F7931E) colors
• High contrast black/white themes
• 3px borders with sharp shadows (no blur)
• Arial Black typography with uppercase headings
• Geometric decoration elements
• Modern, professional yet edgy aesthetic

🚀 Getting Started

1. Export your IMDb watchlist

1. Go to your IMDb Watchlist
2. Click the "Export" button
3. Save the CSV file

2. Upload and discover!

1. Open index.html in your browser
2. Click "Upload CSV file"
3. Select your exported CSV
4. Start discovering movies!

⌨️ Keyboard Shortcuts

• Space - Pick a random movie
• T - Toggle dark/light mode
• U - Upload CSV file
• F - Toggle filters
• H - Toggle history
• V - Toggle favorites
• W - Toggle watched movies
• C - Clear filters
• ? - Show shortcuts help

📱 Touch Gestures

• Swipe left/right - Pick another random movie

🛠️ Technical Details

• Pure vanilla JavaScript - No frameworks needed
• Client-side only - All processing happens in your browser
• API Integration - TMDB & OMDb for movie data
• Local Storage - Favorites and watched movies persist
• Responsive Design - Works on mobile, tablet, desktop
• Progressive Enhancement - Works without JavaScript (degrades gracefully)

🔌 APIs Used

• The Movie Database (TMDB) - Movie details, cast, crew, trailers
• OMDb API - IMDb ratings, Rotten Tomatoes, Metacritic scores

📁 Project Structure

IMDb-Watchlist-Picker/
├── index.html          # Main HTML file
├── style.css           # Neo-brutalist design system
├── README.md           # This file
└── favicon.ico         # App icon

🌟 Features in Detail

Filters

Narrow down your choices by:

• Genre - Action, Comedy, Drama, etc.
• Year - 2020s, 2010s, 2000s, 1990s, 1980s, or older
• Runtime - Short (<90min), Medium (90-120min), Long (>2h)

Session Stats

Track your session:

• Movies viewed
• Movies remaining
• Genres explored
• Total favorites

Favorites

• Click ★ on any movie to add to favorites
• View all favorites in the Favorites section
• Filter to show only favorites

Watched Tracking

• Mark movies as watched with ✓ button
• Watched movies excluded from random picks
• View all watched movies
• Clear watched history anytime

History

• Last 10 movies viewed
• Click any history item to reload that movie
• Shows favorite/watched status

🔒 Privacy

Your data never leaves your browser:

• ✅ All processing is client-side
• ✅ No server uploads
• ✅ No tracking or analytics
• ✅ Favorites/watched stored locally
• ✅ Your watchlist stays private

💡 Tips

1. Use filters to narrow down options when you know what mood you're in
2. Mark favorites as you discover them to build a curated list
3. Track watched movies so you don't get repeats
4. Try keyboard shortcuts for faster navigation
5. Swipe on mobile for quick browsing

🐛 Known Issues

• Some older movies may have limited data
• API rate limits may slow down rapid clicking
• Stremio links require Stremio app installed

📝 License

MIT License - Feel free to use and modify!

🙏 Credits

• Movie data from TMDB and OMDb
• CSV parsing by PapaParse
• Icons from system emoji
• Design inspired by neo-brutalist web design movement

🤝 Contributing

Contributions welcome! Feel free to:

• Report bugs
• Suggest features
• Submit pull requests
• Improve documentation

---

Enjoy discovering your next favorite movie! 🍿