🎬 Mood Match Recommendation App

📖 Description

Mood Match Recommendation App is an interactive CustomTkinter-based GUI that helps users find and explore Movies, Web Series, K-Dramas, and Anime recommendations based on name or genre.
It combines local data (CSV) with live movie details fetched via the OMDb API, offering both fun animations and informative results — all in one visually rich interface.

---

✨ Key Features

• 🎨 Modern CustomTkinter GUI with dark/light themes
• 🧠 Smart Recommendation Engine
  • Search by Name (live OMDb API)
  • Search by Genre (from local CSV datasets)
• 📚 Supports multiple categories:
  • Movies
  • Web Series
  • K-Dramas
  • Anime
• 🖼️ Poster and Details View
  • Automatically displays poster, ratings, year, plot, director, runtime, etc.
• 💾 Auto Save to Local Database
  • Automatically adds new found titles to CSV files for offline use.
• ⚙️ Smooth Page Transitions
  • Unique animated transitions between pages (slide, zoom, fade).
• 🌗 Dark/Light Theme Toggle
• 🚪 Exit & Navigation
  • One-click back, home, and exit options.

---

📸 Screenshots

---

🧩 Tech Stack

• Python 3.10+
• CustomTkinter for UI
• Pillow (PIL) for image processing
• urllib + json for OMDb API integration
• csv for dataset handling
• threading for smooth UI
• OMDb API for live movie information

---

📂 Folder Structure

Movies and Web Series Recommendation App/
│
├── main.py # Main application file (this script)
├── Api_omdb.txt # File containing your OMDb API key
├── Movies.csv # Local dataset for movies
├── Webseries.csv # Local dataset for web series
├── K_drama.csv # Local dataset for K-dramas
├── Anime.csv # Local dataset for anime
└── Recommendation App GUI/
└── Back_photo_laptop.png # Background image for the GUI

---

⚙️ Setup & Usage

1. 🧠 Install Dependencies

pip install customtkinter pillow

2. 🔑 Set Your OMDb API Key

Create a file named Api_omdb.txt

Paste your OMDb API key inside it (no extra spaces or newlines)

3. 📁 Prepare Local CSV Files

Each CSV file should have proper columns:

Movies.csv: Title, Year, Genre, IMDb Rating, Language, Director, Country

Webseries.csv: Title, Year, Platform, Genre, Language, IMDb Rating, Country

K_drama.csv: Title, Year, Platform, Genre, Language, IMDb Rating, Country

Anime.csv: Title, Genre, IMDb Rating, Language, Country

4. ▶️ Run the App

bash Copy code python main.py

5. 🧭 Navigation

Tap Anywhere on the home screen to start

Choose your Category (Movies / Webseries / K-Drama / Anime)

Select Search by Name or Genre

View Results and Recommendations

🌐 OMDb API

Get your API key for free at: 👉 https://www.omdbapi.com/apikey.aspx

🧑‍💻 Author

Created BY Vaibhav-coder-king