BingeSuggest🍿: Your Destination for Movie Recommendations

BingeSuggest 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, BingeSuggest is here to transform the way you discover, enjoy, and connect with movies.

Contents

• Why use BingeSuggest?
• Project Documentation
• Project Presentation Videos
• Brief Overview of Project
• What Docs
• How Docs
  
  • Recommendation Mechanism
    
  • Email Notifier
  • Create an Acccount
  • Login to Account
  • Profile and Friends
  • Wall
• Improvements Made in the Project
• TechStack Used for the Development of Project
• Steps for Execution
• Future Scope
• Contribute
• Team Members
• Contact
• License

Why use BingeSuggest?

BingeSuggest: Your movie recommender! Input movies, get tailored suggestions, and share via email. 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!"

Documentation

Checkout for project documentation here

Project Presentation Videos

New Features 2 minute demo

Why contribute?

Project Description

BingeSuggest 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, BingeSuggest offers the convenience of emailing the recommended movies, enhancing the movie-watching experience. For the system architecture and other details, please refer to our documentation here

What docs

View our documentation outlining each class and function of BingeSuggest here

• Backend
• Frontend
• Testing

View our autogenerated doco here Doco

How docs

Movie Recommendation Mechanism

(Modified in version 6)

The user selects upto 5 movies to get relevant recommendations based on genre, director, actor, and all combined. User can also provide feedback for the same!

Watchlist

(New in version 6)

The user can add movies to watchlist

Email Notifier

The user sends his/her movies feedback via an email (Notify Me button)

Create an Account

Users can now create accounts, persisting data including their movie reviews and recommendations

Login to account

The user can log in to their account securly with encrypted passwords stored in our database

Profile and Friends

The user can add friends, view the movies reviewed by the friends, and see their reviewed movies in their profile

Wall

The user can interact with other users, by viewing a community sourced wall of recent moview reviews

Project 3 Delta

Check out the significant changes that we made for Project 3 here

Our grading scorecard can be found here

Tech stack Used👨‍💻:

Getting Started

Step 1: Git Clone the Repository

git clone https://github.com/svd-ncsu/BingeSuggest.git

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

https://github.com/svd-ncsu/BingeSuggest

Step 2: Follow the setup instructions in the installation documentation

https://github.com/svd-ncsu/BingeSuggest/blob/v6.0/docs/install.md

Finally, start enjoying personalized movie recommendations!

Future Scope

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

1. User Profiles and Preferences: Continue to improve user profiles. More features could be added with friend interaction, such as ability to send messages. More data on the users could be persisted such as preferences and watch history for a more personalized movie discovery experience.

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

3. 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.

4. Frontend rework: Currently the frontend uses jquery, which is a bit dated. As the program becomes more complex, it may be nice to use a component based architecture such as React, Angular, or Blazor.

The future of BingeSuggest 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 BingeSuggest source code. Follow all the guidelines mentioned in the same and raise a pull request, we would love to look at it ❤️!

Contributors

Version 6

Shail Patel

Vrushali Ranadive

Devanshu Shah

Version 5

Brandon Walia

Nathan Kohen

Nicholas Foster

Robert Kenney

Version 4

Aditya Pai Brahmavar

Rishi Singhal

Ananya Mantravadi

Samarth Shetty

Contact

In case of any issues, please e-mail your queries to [email protected] or raise an issue on this repository.
Our team of developers monitors this e-mail address and would be happy to answer any and all questions you have about setup or use of this project!

Join the BingeSuggest Community:

Contribute to the project and help us improve recommendations. Share your experience and film discoveries with us. Together, let's make BingeSuggest the ultimate movie companion! BingeSuggest 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 BingeSuggest! Let's make movie nights extraordinary together!

License

This project is under the MIT License.