Skip to content

Userscript that allows you to relax and avoid any spoilers from thumbnails, titles, etc on Crunchyroll. Click below to install ๐Ÿ‘‡

License

Notifications You must be signed in to change notification settings

zAlfok/ByeSpoilers-Crunchyroll

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

92 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Bye Spoilers - Crunchyroll

Userscript that allows you to relax and avoid any spoilers from thumbnails, titles, etc on Crunchyroll. Inspired on TimeBomb's script (https://greasyfork.org/users/160017).

๐Ÿ“– Overview

If you use Crunchyroll and are fed up with episode titles or thumbnails (totally not spoiler-ish wink wink) revealing what's going to happen (probably not the most crucial part wink wink), or if you're scrolling through the episode list (trusting that no title or thumbnail will spoil a character's death wink wink) only to find out someone dies N episodes later, then this script is your new best friend! Let's break down what this script censors and how it works.

๐Ÿ“ท Screenshots

Note: I am using Dark Reader (enables automatic dark mode on any site) and AdGuard (adblocker) extensions, so you may notice slight differences between the appearance in my screenshots and your actual results.

Crunchyroll WITHOUT ByeSpoilers Crunchyroll WITH ByeSpoilers
Imagen 1 Imagen 2
Imagen 3 Imagen 4
Imagen 5 Imagen 6
Imagen 7 Imagen 8
Imagen 9 Imagen 10
Imagen 11 Imagen 12

๐Ÿ“‚ Installation

In order to use the script you should install a script-manager like Violentmonkey, Tampermonkey, etc. To do this you can search on the extension store of your browser. For those mentioned on Chrome/Firefox just click the buttons below to go to their store pages:

Violentmonkey Violentmonkey

Tampermonkey Tampermonkey


Then you have to install ByeSpoilers Script: Install

To do that make sure to click "Install + Edit" so you can modify the USER_CONFIG according to your preferences (if you'd like to).


After that, make sure to mark the checkbox "Allow edits," change the USER_CONFIG settings by toggling true or false for each feature, and then click the "Save" button (or press Ctrl + S) to apply the changes. After each time you save the script, you must refresh Crunchyroll (if it was open) to see the updates.

โš ๏ธ NOTICE THAT, AS STATED NEXT TO THE ALLOW EDITS CHECKBOX, ANY CHANGES THAT YOU MAKE WILL BE LOST IF THE SCRIPT IS UPDATED SO YOU'LL HAVE TO SET YOUR PREFERENCES AGAIN.

๐Ÿ†• Skip in-video titles feature

A new feature has been added. The idea is that you won't have to worry even for the titles inside the same video by skipping them automatically. However, it is needed the data about the time intervals of each episode so, right now this feature is kind of useless since there are very few (about 10 by the time I'm writing this). Because of that I'll need your help.
If you are interested in contributing, please send me an email (find below in Feedback section).

Instructions to use this feature (tested in Violentmonkey and Tampermonkey): Change the default values of FETCH_INSTEAD_OF_RESOURCE and SKIP_EPISODE_TITLES in USER_CONFIG to true (default values: false). Note: The rest of the options can also be customized to adjust the censorship.


ALTERNATIVE: If using Violentmonkey, you can keep FETCH_INSTEAD_OF_RESOURCE: false, but you'll have to "update" the script manually each time you want to see changes of the database (it will indicate that there are no updates since the script probably hasnโ€™t changed, but we do this to update the resource, that is, the database.). This could be useful for collaborators.

โญ Information and features

  • What will it protect you from?
    Spoilers sneaking up like ninjas in the following pages:

    • /home: Continue Watching Grid, Watchlist Grid (Hover),
    • /watchlist: Grid of Episodes (Hover)
    • /history: Grid of Episodes
    • /series: Last Episode, Grid of Episodes
    • /watch: Info wrapper, Next/Previous Episode, See More Episodes (Side and PopUp)
  • Howโ€™s this spoiler-shielding sorcery supposed to work?
    Since spoilers can come from all sorts of places and in all sorts of forms, fortunately, we just have to focus on 6 things: thumbnails, titles (on the site and the tab), descriptions, URL's and tooltips (when you keep your mouse over an element and it displays like a mini-mini-popup). So the script has a initial configuration section in which you can choose the level of censorship. You will be allowed to choose (in USER_CONFIG as explained before) to:

    • Blur episode's thumbnails (default enabled): Notice that not all thumbnails are episode-related so just those have blur.
    • Blur episode's titles (default disabled): Notices that this will blur the entire title element, so you'll not be able to see the episode number either.
    • Blur episode's descriptions (defalut enabled): Just blurs episode-related descriptions...
    • Modify episode's titles (default enabled): It transforms the '((S#) E# - )Episode Title' pattern into '((S#) E# - )[Title Censored]'. In some elements, the season and episode numbers are not part of the title, which is why they are in parentheses. This is applied to page content, tooltips, URLs, and the browser tab. About the URL censorship, it will modify your history entry on your browser, that means that the censored title will appear there instead of the original one.
    • *Hide Premium Trial-related stuff (default disabled): This hides the banner (on /watch pages), the nav icon (on the top bar), and the menu button (inside the drop-down menu). Disabled by default since it's not the main purpose of the script, but might be useful to some people.
    • NEW: Skip in-video titles. A new feature in development. If you want to contribute please send me an email (could find below in Feedback section).
  • Which languages does it support?
    Based on Crunchyroll's language list in configuration.

  • Does it works 100% of time?
    Wish to say yes... but actually don't really know. It has worked 99% of the time in my tests, but it's challenging due to the dynamic way Crunchyroll structures their site. If something goes wrong, just give the page a refresh. The script is supposed to blur the entire page when it first loads (cause that's when things are the trickiest, with so much loading at once) until everything that needs to be censored is covered.

  • How did it start?
    I was tired of being spoiled mainly due to titles and began searching for extensions or scripts but had little luck until I found TimeBomb's script, which didnโ€™t work well, probably due to updates on Crunchyrollโ€™s site. So, I decided to create my own based on the latest changes of the site (around July 2024). Iโ€™m not a web developer, or even a developer; this is just a hobby, so that's why you might find some bugs as said before.

๐Ÿง‘โ€๐Ÿ’ป Contributing

As said before, this script may have some bugs. Please report in the issues section them in order to improve the code. The current version doesnโ€™t have comments (except for the config part) since everything was disorganized. Iโ€™ll be working on that (if you want to understand the code more than anything). In general, any kind of contribution is greatly appreciated.

โœ‰๏ธ Feedback

If you have any feedback, you can also leave it in the issues section. It doesn't have to be a bug to contribute, as said before help is needed to finish the new skip in-video feature. email: jose974044@gmail.com

~ An enthusiast trying to do his best ~