Skip to content

Godatcode/Movie-TV-Show-Finder

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

14 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Movie Finder App 🎬

πŸ“Œ Project Overview

Movie Finder is a web application that allows users to search for movies, view trailers, check streaming platform availability, and save favorite movies. It integrates OMDB and TMDB APIs to fetch movie details, ratings, and watch providers. Additionally, users can enable dark mode and use a "Surprise Me!" feature to get random movie suggestions.

πŸš€ Features

  • πŸ” Search Movies & TV Shows (OMDB API)
  • 🎞 Watch Movie Trailers (TMDB API)
  • πŸ“Ί Check Streaming Platform Availability (TMDB API)
  • ❀️ Add/Remove Favorites (LocalStorage)
  • 🎭 Surprise Me! - Suggests a random movie
  • πŸ—£ Voice Search - Search using voice recognition
  • πŸŒ™ Dark Mode Toggle

πŸ›  Technologies Used

  • HTML, CSS, JavaScript
  • OMDB API & TMDB API (for movie details, trailers, streaming info)
  • LocalStorage (for saving favorites)
  • Google Speech Recognition (for voice search)

πŸ“‚ File Structure

πŸ“¦ Movie Finder Project
 ┣ πŸ“œ index.html       # Main HTML file
 ┣ πŸ“œ style.css        # Stylesheet
 ┣ πŸ“œ script.js        # Main JavaScript file
 ┣ πŸ“œ config.js        # API key configuration (excluded in GitHub)
 ┣ πŸ“œ README.md        # Project Documentation
 ┣ πŸ“œ .gitignore       # Ignore config.js (to hide API keys)

βš™οΈ Setup & Installation

1️⃣ Clone the Repository

git clone https://github.com/your-username/movie-finder.git
cd movie-finder

4️⃣ Run the Project Locally

Simply open index.html in your browser.


🌍 Deployment

You can deploy the project using GitHub Pages, Netlify, or Vercel.

Deploy on GitHub Pages:

  1. Push your project to GitHub.
  2. Go to Settings β†’ Pages.
  3. Select the main branch and set root as /.
  4. Click Save and get your live link.

πŸš€Live Demo

Movie-TV-Show Finder


πŸ”—At A Glance

Screenshot 2025-02-13 at 12 10 48β€―AM

🎯 How It Works

  1. Search for a movie β†’ Fetches movie info from OMDB API.
  2. Click on a result β†’ Fetches trailer & streaming info using TMDB API.
  3. Add to Favorites β†’ Saves the movie to LocalStorage.
  4. Use Voice Search β†’ Enables speech recognition for search.
  5. Toggle Dark Mode β†’ Switches between light & dark theme.
  6. Surprise Me! β†’ Shows a random movie recommendation.

πŸ“’ Contributing

  1. Fork the repository 🍴
  2. Create a new branch feature-new 🌿
  3. Make your changes & commit πŸš€
  4. Submit a Pull Request πŸ”₯

πŸ“œ License

This project is open-source under the MIT License.


🀝 Acknowledgments

  • OMDB API for movie data 🎬
  • TMDB API for trailers & streaming info πŸ“Ί

πŸŽ‰ Thank You & Happy Coding! πŸš€πŸŽ¬

And Don't Forget to check the Updates πŸ˜‡πŸš€

About

Here's the ultimate finder You only need to "JUDGE" a EpisodeπŸ“ˆ

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published