Spoiler Blocker

Block spoiler content on social media and video platforms. Custom keywords, blackout or remove mode, 9 platforms supported.

Install this script ?

Ask a question, post a review, or report the script.

Author

Ran Shin

Daily installs

Total installs

Ratings

1 0 0

Version

1.4.1

Created

2026-03-17

Updated

2026-04-23

Size

60.1 KB

License

MIT

Applies to

Spoiler Blocker

Automatically block spoiler content on social media and video platforms using custom keywords.

✨ Features

Custom Keywords — Add movie names, character names, etc. Matching posts/videos are blocked automatically
Two Block Modes — Blackout (blurred overlay, click to reveal) or Remove (completely hidden)
Global / Per-Platform — Apply to all platforms at once, or choose individually
9 Languages — Auto-detects browser language, or switch manually
Real-time — Changes take effect immediately, no page refresh needed

🌐 Supported Platforms

Platform	Coverage
X (Twitter)	Tweets, link cards, quoted tweets
Weibo	Posts, reposts, topics
Bilibili	Homepage, dynamic feed, creator pages, search results
YouTube	Video titles, descriptions, channel pages
Instagram	Posts, Reels, image descriptions
Facebook	Posts, videos, link previews
Niconico	Video lists, rankings, search
Threads	Posts, hashtags
Xiaohongshu (RED)	Explore page, note details

📖 How to Use

Installation

Make sure you have Tampermonkey or Violentmonkey installed
Click the "Install this script" button on this page
Click "Install" on the confirmation page

Open the Settings Panel

There are two ways to open the settings panel:

Option 1: Click the 🛡 floating button (bottom-right corner)

On any supported platform, a blue shield button appears at the bottom-right. Click it to open the settings panel.

Option 2: Via Tampermonkey menu

Click the Tampermonkey icon in your toolbar → Find the "⚙ Settings" command → Click to open the settings panel.

Settings Overview

Setting	Description
Enable Toggle	Master switch — turn off to stop all blocking
Block Mode	"Blackout" = blurred overlay, click to reveal; "Remove" = completely hidden
Platform Mode	"Global" = all platforms; "Per-platform" = choose which to enable
Keyword Management	Type a keyword and press Enter to add; click × to remove. Case-insensitive matching
Language Selector	Top-right dropdown, 9 languages available

Example

To avoid spoilers for a new movie:

Open the settings panel
Type the movie name in the keyword field, press Enter
Add more: character names, director name, etc.
Browse any supported platform — posts containing those keywords are blocked
In Blackout mode, the overlay shows the matched keyword; click to temporarily reveal

Languages

The script auto-detects your browser language on first run. You can switch anytime from the top-right dropdown:

English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Español · Português · Français · Deutsch

❓ FAQ

Q: Keywords don't seem to work? A: Content loaded before adding keywords needs a page refresh. New content is blocked in real-time.

Q: Blackout mode doesn't fully cover some content? A: Some platform layouts may cause imperfect overlay coverage. Try "Remove" mode for complete hiding.

Q: Does it support regex? A: Currently only plain text keywords are supported (case-insensitive).

Q: Where is my data stored? A: All settings and keywords are stored locally via Tampermonkey's storage (GM_getValue/GM_setValue). Nothing is sent to any server.

Q: How is this different from the Chrome extension version? A: Identical functionality. The userscript version works on more browsers (Firefox, Safari, etc.) and uses a floating panel instead of a browser popup.

🔒 Privacy

No personal data collected
No network requests sent
All data stored locally

📝 Open Source

Licensed under MIT: GitHub