Skip to content

Trident09/watch-buddy

Repository files navigation

Watch - Buddy

Description

Watch Buddy is a movie streaming website that seamlessly integrates with TMDB, a leading movie database, to provide users with a vast collection of movies. By leveraging the power of TMDB, Watch Buddy fetches comprehensive movie data, including ratings, reviews, and cast information, ensuring an immersive movie streaming experience.

With Watch Buddy, users can enjoy high-quality videos sourced from vidsrc, a trusted video hosting platform. Whether it's the latest blockbusters or timeless classics, Watch Buddy offers a diverse range of movies to cater to every taste and preference.

Experience the convenience and excitement of Watch Buddy as you explore new movies, discover hidden gems, and indulge in your favorite films. With its user-friendly interface and seamless streaming capabilities, Watch Buddy is your ultimate companion for an unparalleled movie-watching experience.

This is my personal project and I have made it for educational purposes.

Table of Contents

Installation

  • Get a TMDB API key from the TMDB website.
  • Fork or clone the repository to your local machine.
    git clone https://github.com/Trident09/watch-buddy.git
  • Open a terminal and navigate to the project directory.
  • Run the command npm i to install all the project dependencies.
  • Create a .env file in the project root directory.
  • In the .env file, add the following line:
    REACT_APP_API_KEY=YOUR_API_KEY
  • Replace YOUR_API_KEY with your actual TMDB API key.
  • If you plan to host the project, set the REACT_APP_API_KEY as an environment variable on your hosting platform.
  • Once the dependencies and API key are set up, the project is ready to run.
  • You can start the project by running the command npm start in the terminal.
  • Open a web browser and navigate to http://localhost:3000 to access the website.
  • Customize the website as per your requirements.

Features

Watch Buddy offers a wide range of features to enhance your movie streaming experience:

  • High-Quality Videos: Enjoy movies in stunning high-definition quality for an immersive viewing experience.

  • Free Video Streaming: Watch Buddy provides free access to a vast collection of movies, allowing you to enjoy your favorite films without any subscription fees.

  • Comprehensive Ratings: Get detailed ratings for each movie, helping you make informed decisions about what to watch next.

  • Cast Information: Explore the cast and crew of each movie, including actors, directors, and producers, to gain insights into the talent behind the scenes.

  • User-Friendly Interface: Navigate through the website effortlessly with a clean and intuitive interface, making it easy to find and stream your favorite movies.

  • Seamless Streaming: Experience smooth and uninterrupted movie streaming, thanks to Watch Buddy's seamless integration with the trusted video hosting platform, vidsrc.

  • Diverse Movie Collection: Discover a diverse range of movies, including the latest blockbusters, timeless classics, and hidden gems, catering to every taste and preference.

  • Educational Purpose: Watch Buddy is a personal project created for educational purposes, allowing you to learn and explore the world of movie streaming.

Enjoy the convenience, quality, and excitement of Watch Buddy as you indulge in a captivating movie-watching experience.

Screenshots

Home Page - Trending Movies and TV Shows

Trending Page

Movies Page

Movies Page

Series Page

Series Page

Search Page with different tabs to search for Movies and TV Shows

Search Page for Movies and TV Shows

Contributing

Thank you for considering contributing to Watch Buddy! To contribute to this project, please follow these guidelines:

  1. Fork the repository and clone it to your local machine.
  2. Create a new branch for your contribution.
  3. Make your changes or additions to the codebase.
  4. Test your changes to ensure they work as expected.
  5. Commit your changes with a descriptive commit message.
  6. Push your changes to your forked repository.
  7. Submit a pull request to the main repository.

Please ensure that your contributions align with the project's coding standards and guidelines. If you are unsure about anything, feel free to reach out to the project maintainers for clarification.

By contributing to this project, you agree to license your contributions under the MIT License.

We appreciate your contributions and look forward to your valuable input!

License

This project is licensed under the MIT License.