SpoilerAlert

Fed up with spoilers ruining your movie experience? Let SpoilerAlert block them before you see them.

Comment

SpoilerAlert

Introduction

Welcome to SpoilerAlert, a project designed to help users avoid unwanted spoilers while browsing the web. This tool leverages MongoDB to detect and block spoilers in real-time, ensuring a spoiler-free browsing experience.

Background

In 2019, Avengers: Endgame was released. It was the culmination of more than a decade's worth of movies and storytelling; it brought together characters from all 21 Infinity Saga movies. With the overall success of this movie, it also highlighted the growing issue of spoilers, and many online initiatives were made to stop the spread of leaks and rumors.

With several solutions in place for this via extensions, many are not up to data safety standards. As well, many will become unsupported by Firefox Add-ons and the Chrome Web Store for this reason. SpoilerAlert aims to maintain safety standards by limiting the amount of external libraries while still giving users the best spoiler-free experience.

Features

  • Customizable Filters: Allows users to set their own spoiler date preferences and filters.
  • Browser Extension: Available as a browser extension for easy integration and use.
  • User-Friendly Interface: Simple design for easy user experience.

Technologies Used

  • Web Development: Built with JavaScript for the front-end and Node.js for the back-end.
  • Database: Utilizes MongoDB Atlas for data management.
  • Browser Extension: Developed using JavaScript, HTML, and CSS.

How It Works

  1. Data Collection: Gathers data from TMDB and uses an API to populate the Mongo database.
  2. Date Range: Users provide a custom range of time that they want movies blocked off.
  3. Results!!!

Future plans

LLM: We plan on adding an LLM down the road. With this project, we did look into custom-trained Hugging Face LLMs that predetermine if a specific string is considered a spoiler or not. Data Encryption: We aim to implement data encryption techniques to ensure the security and privacy of user data. This could potentially involve using dependencies such as Midnight. Chrome Publication: We are hopeful about publishing our project as a Chrome extension. This would allow users to easily integrate our tool into their browsing experience, providing seamless access to its features directly from their web browser.

Challenges

The biggest challenge was definitely the censoring spoiler data. With jQuery and older forms of JavaScript becoming obsolete, it was fun to dive into the nitty-gritty of JS and figure out workarounds to get this to work. Additionally, not collecting user data makes removing spoilers more tricky, but overall, we managed to overcome these challenges and come out on top.

Installation

To install the SpoilerAlert browser extension, please follow these steps:

  1. Clone or download this repository: Repo
  2. Open Chrome and navigate to: chrome://extensions/.
  3. Enable Developer mode.
  4. Click "Load unpacked" and select the project folder.

Contributing

We welcome any contributions from the community! If you're interested in contributing to SpoilerAlert, please follow these steps:

  1. Fork the Repository: Repo
  2. Create a Branch: git checkout -b feature-branch
  3. Make Changes: Implement your changes and commit them.
  4. Submit a Pull Request: Open a pull request for review.

Contact

For any questions or feedback, feel free to reach out:

Share this project:

Updates