CineMatch is an AI-powered movie discovery engine that bridges the gap between static recommendations and an immersive streaming experience. Built entirely in Python, it leverages the TMDB Live API to provide real-time trending data, smart recommendations, and watchable trailers in a streaming-platform style interface.

🔗 Live Demo: Launch App

Trending Dashboard	Movie Details & Trailers
Curated dashboard with live trending movies	Immersive details page with embedded trailers

• Embedded Trailers: Automatically finds and embeds official YouTube trailers.
• Rich Metadata: Displays dynamic backdrops, release years, runtimes, and ratings.
• Smart Recommendations: Uses TMDB’s collaborative filtering to suggest similar movies.

• Instantly fetches the Top 10 Trending Movies of the week.
• Displays results in a responsive, clickable image grid — streaming-platform styled.

• Debounced Search to avoid API rate limits.
• Auto-complete suggestions (e.g., typing "Spider" shows “Spider-Man: No Way Home”, etc.).
• Auto-clears input after selection for smoother flow.

• Session State for persistent navigation.
• Custom CSS for a “Dark Mode cinema” look (Bebas Neue).
• Integrates streamlit-searchbox and st-clickable-images.

• Frontend: Streamlit (Python)
• Data Source: TMDB API
• Libraries:
  • streamlit-searchbox
  • st-clickable-images
  • requests
• Styling: Custom CSS Injection

1. Clone the repository

   git clone https://github.com/thanyow/CineMatch.git
   cd CineMatch

2. Install dependencies

   pip install -r requirements.txt

3. Get your API Key

   • Sign up at The Movie Database (TMDB).
   • Go to Settings → API to create your key.

4. Configure Secrets
   Create .streamlit/secrets.toml:

   tmdb_key = "YOUR_API_KEY_HERE"

5. Run the App

   streamlit run src/recommender.py

CineMatch/
├── .streamlit/
│   └── secrets.toml
├── assets/
│   ├── dashboard.png
│   └── details.png
├── src/
│   └── recommender.py
├── .gitignore
├── README.md
└── requirements.txt

• Data from The Movie Database (TMDB)
• Built with Streamlit
• Developed by thanyow

This product uses the TMDB API but is not endorsed or certified by TMDB.