YouTube Playlist Blackout

A Tampermonkey userscript that blacks out video thumbnails from a specific YouTube playlist and hides spoiler information (like sports scores) across all of YouTube.

Features

• Thumbnail Blackout: Completely blacks out thumbnails of videos from a specified playlist
• Spoiler Protection: Rewrites video titles to hide scores (e.g., "Chelsea 1-2 Aston Villa" becomes "Chelsea vs Aston Villa")
• Comprehensive Coverage: Works across ALL YouTube locations:
  • YouTube home page
  • Search results
  • Playlist pages and headers
  • Suggested videos sidebar
  • End screen cards (video player overlays)
  • Video wall suggestions (suggested videos on player)
  • Playlist panel (right side when watching from playlist)
  • Watch page titles
  • Browser tab titles
• Dynamic Updates: Handles YouTube's infinite scroll and SPA navigation automatically

Installation

Prerequisites

Install Tampermonkey extension for your browser:

• Chrome Web Store
• Firefox Add-ons
• Edge Add-ons

Install from GitHub (Recommended)

1. Click this link to install: pl-spoiler-block.user.js
2. Tampermonkey will open and show the installation page
3. Click "Install"

The script will automatically check for updates from GitHub.

Manual Installation

1. Download pl-spoiler-block.user.js
2. Open Tampermonkey dashboard
3. Click the "+" tab to create a new script
4. Paste the script content
5. Click File > Save (or Ctrl+S)

Configuration

By default, the script is configured for a specific playlist. To customize:

1. Open Tampermonkey dashboard
2. Click the edit icon next to "YouTube Playlist Blackout"
3. Find line 17: const PLAYLIST_ID = 'PLISuFiQTdKDWLIeau9w3aVwtiFsKwarBe';
4. Replace the playlist ID with your desired playlist
   • You can find the playlist ID in the URL: youtube.com/playlist?list=YOUR_PLAYLIST_ID
5. Save the script (Ctrl+S)

How It Works

1. Fetches Video IDs: On page load, the script fetches all video IDs from the specified playlist
2. Monitors Page Changes: Uses MutationObserver to watch for new content (infinite scroll, navigation)
3. Processes Thumbnails: When matching videos are found, it:
   • Applies brightness(0) filter to make thumbnails completely black
   • Hides thumbnail overlays
   • Rewrites titles to remove score information
4. Tab Title Protection: Continuously monitors and updates the browser tab title to prevent spoilers

Title Rewriting

The script automatically detects and rewrites titles containing scores. It supports multiple formats:

Format 1 (with pipes):

| Team A 1-0 Team B |

Format 2 (description with score):

Description text | Team A 1-0 Team B | Suffix

Both are rewritten to:

Team A vs Team B

The script splits titles by the | character and looks for segments matching the pattern Team A [score] Team B, then removes the score to prevent spoilers.

Troubleshooting

Thumbnails aren't being blacked out

• Make sure you've configured the correct playlist ID
• Check the browser console (F12) for [Blackout] messages
• Verify Tampermonkey is enabled for YouTube

Titles still show scores

• The script looks for titles with pipe-separated segments containing Team A [score] Team B patterns
• The score must be in format X-Y (e.g., "1-0", "3-2")
• If your titles use a completely different format, you may need to adjust the logic in the getRewrittenTitle() function

Script not updating automatically

• Verify the @updateURL and @downloadURL in the script header point to your GitHub repository
• Check Tampermonkey settings for update frequency

Development

Local Testing

1. Make changes to the script
2. Save in Tampermonkey
3. Refresh YouTube to test

Publishing Updates

After pushing changes to GitHub:

1. Increment the @version number in the script header
2. Users will automatically receive updates based on their Tampermonkey settings

License

MIT License - Feel free to modify and distribute

Credits

Author: Antigravity