-
-
Notifications
You must be signed in to change notification settings - Fork 0
User Guide
Everything you need to install, configure, and use Zap to block unwanted YouTube content.
- Load the extension (for development) via chrome://extensions → "Load unpacked" and select the extension folder.
- Allow permissions for https://www.youtube.com/* when prompted.
- Open YouTube and verify the Zap button appears on video thumbnails (top-left).
Use the Keyword Manager to automatically hide videos whose titles match your keywords or phrases.
- Open Keywords tab.
- Enter one keyword per line (or comma-separated), then click Save Keywords.
- Up to 1000 keywords supported. Matching is case-insensitive.
Tip: Start with short phrases and expand if needed. Use exact phrases to reduce false positives.
The Blocked Videos tab shows videos you manually or automatically blocked. Actions available:
- Unblock — restore the video to YouTube feed.
- Export — download JSON backup.
- Clear All — remove all blocked entries.
Select languages you want Zap to hide automatically. This is useful for hiding content in languages you don't read.
Use the Support tab to send bug reports, suggestions, or contact the team. The extension tries to deliver messages to a Telegram channel — if offline, messages are queued locally.
When filing a bug, include:
- Browser version and OS
- Steps to reproduce
- Console errors (open Developer Tools → Console)
Zap uses Chrome storage and content scripts to match titles and hide nodes. If YouTube changes structure, the selector rules might need an update — check the extension's content scripts and background logs for troubleshooting.