Skip to content

CSCI510testerhw1/PopcornPicks

 
 

Repository files navigation

PopcornPicks🍿: Your Destination for Movie Recommendations

Maintenance Contributors Activity GitHub issues GitHub issues-closed GitHub closed pull requests PRs Welcome License: MIT DOI Unittest codecov GitHub release StyleCheck: pylint HitCount GitHub contributors GitHub Release Date - Published_At GitHub repo size

drawing

PopcornPicks is more than just a movie recommender system; it's a gateway to a world of cinematic adventures. With an ever-expanding library of films and a powerful recommendation algorithm, PopcornPicks is here to transform the way you discover, enjoy, and connect with movies. Now totally personalized with new user profiles!

Contents

Why use PopcornPicks?

Watch our video: https://youtu.be/rbT5nZ8c32o

PopcornPicks: Your movie recommender! Input movies, get tailored suggestions, and save them to your profile. Elevate your movie choices effortlessly!

  • Efficient: Lightning-fast recommendations for movie buffs! 🚀
  • Adaptable: Tailor the recommendations to your taste.
  • Accessible: Works across all platforms and shells.
  • Insightful: Get movie insights at a glance.
  • Comprehensive: Supports a wide array of user-preferred movies.
  • Simple: Easy installation and setup – start discovering great movies in no time!"
  • Personal: Save and curate your watchlist on your very own Popcorn Picks account!

Documentation

Checkout for project documentation at our wiki page

Features

For a detailed breakdown of our current features, see our video: - https://youtu.be/vaSMBwAT0yw

Project Description

PopcornPicks is a user-friendly movie recommender that curates a tailored list of 10 movie predictions based on user-provided movie preferences. Users can input their favorite movies, and our algorithm refines recommendations based on feedback—Liked, Disliked, or Yet To Watch. Additionally, PopcornPicks offers the convenience of saving recommendations to your account watchlist, enhancing the movie-watching experience. For the system architecture and other details, please refer to our wiki page

How to Use:

Start Screen

This is the first screen you see when the service launches. From here you can either sign into your existing PopcornPicks account or create a new one.

Sign Up Screen

The user creates a custom username and password to create their PopcornPicks account.

Sign In Screen

The user enters their custom username and password to access their PopcornPicks account.

Pick a Movie

Upon a successful log-in, the user is taken to this screen. Here they can choose up to 5 of their favorite movies to generate recommendations based off.

Movie Recommendation Mechanism

The user selects up to 5 movies to get a tailored recommendation list they can choose to add to their Watchlist.

Watchlist

If you click the "Watchlist" tab in the header, you are taken to this page and shown what movies you've saved to your watchlist

Tech stack Used👨‍💻:

Getting Started

Step 1: Git Clone the Repository

git clone https://github.com/CSCI510testerhw1/PopcornPicks.git

(OR) Download the .zip file on your local machine from the following link

https://github.com/CSCI510testerhw1/PopcornPicks

Step 2: Follow the setup instructions in the wiki documentation

https://github.com/CSCI510testerhw1/PopcornPicks/wiki/Installation

Or visit INSTALL.md

Finally, start enjoying personalized movie recommendations!

Future Scope

PopcornPicks is a dynamic project with endless possibilities for expansion and enhancement. Here are some exciting avenues for future development:

  1. Performance Enhancement: Implement load-balancing to ensure robust operation in high-traffic.

  2. Integration with Streaming Services: Integrate with popular streaming services to provide real-time availability information and seamless access to recommended movies.

  3. Movie Reviews and Ratings: Allow users to write and read movie reviews and ratings, fostering a community of film critics and enthusiasts.

  4. Improved Recommendation Algorithm: Enhance the recommendation engine with more advanced machine learning models and collaborative filtering techniques to provide even more accurate and personalized movie suggestions.

The future of PopcornPicks is full of potential, and we invite developers, movie lovers, and anyone passionate about cinema to join us in making this platform the ultimate movie companion.

Contribute to the Project!

Please refer to the CONTRIBUTING.md if you want to contribute to the PopcornPicks source code. Follow all the guidelines mentioned in the same and raise a pull request, we would love to look at it ❤️❤️!

Contributors

Jonas Trepanier
Siddhi Mule
Anirduh Kaluri

Original Contributors:

Aditya Pai Brahmavar
Ananya Mantravadi
Rishi Singhal
Samarth Shetty

Contact

In case of any issues, please e-mail your queries to popcornpicker35@gmail.com or raise an issue on this repository.

Join the PopcornPicks Community:

Contribute to the project and help us improve recommendations. Share your experience and film discoveries with us. Together, let's make PopcornPicks the ultimate movie companion! PopcornPicks is more than just code; it's a passion for cinema, and we invite you to be a part of this exciting journey. Start exploring, sharing, and discovering movies like never before with PopcornPicks! Let's make movie nights extraordinary together!

License

This project is under the MIT License.

About

NCSU CSC 510 project - A movie recommender system

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • Python 40.9%
  • JavaScript 37.0%
  • HTML 11.3%
  • CSS 9.8%
  • Dockerfile 1.0%