CleanTube v1.0.5
A cleaner YouTube. Faster, smarter, and more reliable than ever.
This release brings meaningful improvements to performance, reliability, and the overall experience — refining what CleanTube does best while laying the groundwork for what's coming next.
What's New
Performance
- Replaced the global polling interval with a
MutationObserver-based engine — the extension now reacts to ad injections instead of constantly scanning the page, significantly reducing CPU usage during normal playback - PiP button injection no longer runs on a recurring timer; it now uses a self-stopping observer that tears itself down the moment the button is placed
- MutationObserver scope narrowed to the header container, preventing unnecessary processing of full-page DOM mutations
Reliability
- Removed the hardcoded pixel-coordinate dialog selector that broke across different viewport sizes and YouTube layout variants
- Expanded ad element selectors to cover in-feed promotions, masthead ads, Shorts promotional content, and sidebar banners
- Added
yt-navigate-finishlisteners across all modules so ad blocking and UI enhancements survive YouTube's SPA navigation correctly
Architecture
- Added a background service worker for proper MV3 message routing and persistent stat tracking
- Settings changes now propagate to all open YouTube tabs simultaneously — no reload required
- Content script now runs at
document_startfor earlier ad interception
Fixes
- Removed the
setYouTubeCookiealgorithm which was no longer effective and caused unintended side effects - Removed broken reference to
ytdl-module.jswhich caused a silent script load failure - Ad block toggle in the popup now correctly reflects and controls the live state of the content script
Known Limitations
- YouTube periodically updates its DOM structure; if a selector becomes stale, please open an issue with your YouTube locale and browser version
- Firefox support is not yet official — MV3 compatibility work is planned for a future release
Installation
Download the .zip, extract it, then load via chrome://extensions → Developer Mode → Load Unpacked.
Thank you to everyone who reported issues and shared feedback. Every report makes CleanTube better.