FilterTube v3.2.2

What's New in v3.2.2

UI/UX Improvements & Debug Gating

• Optimistic UI Updates: Added immediate visual feedback when blocking channels - content hides instantly with automatic restoration if blocking fails, eliminating user uncertainty.
• Enhanced Mobile Menu Support: Improved 3-dot menu injection for YouTube mobile (ytm-menu-popup-renderer) with proper renderer tags and scope handling.
• Debug Gated Logging: All console logs now gated behind window.__filtertubeDebug flag to reduce noise in production while maintaining full debug capabilities.
• Scroll Preservation: Enhanced DOM fallback processing to respect user scrolling during filtering operations, preventing jarring scroll position changes.
• Channel Enrichment Limits: Added per-session limits (10 enrichments) to prevent excessive background requests and improve performance.
• Idle-Scheduled Rendering: Channel list rendering now uses requestIdleCallback with batching for smoother UI updates in large lists.

State Management Refinements

• External Reload Debouncing: Storage changes from other tabs now debounced with intelligent signature comparison to prevent unnecessary UI re-renders.
• Selective Notifications: External updates only trigger full 'load' events when channel signatures actually change, otherwise use lightweight 'externalUpdate' events.
• Bridge State Management: Improved script injection state tracking with globalThis-based shared state for better reliability.

---

📥 Installation

🌐 Chrome, Brave, Edge (Chromium)

Download: filtertube-chrome-v3.2.2.zip

1. Download and extract the zip file.
2. Open your browser's extensions page (chrome://extensions, brave://extensions, or edge://extensions).
3. Enable Developer mode.
4. Click Load unpacked.
5. Select the extracted folder.

🦊 Firefox (Desktop & Android)

Download: filtertube-firefox-v3.2.2.zip

Desktop:

1. Download the zip file.
2. Go to about:debugging.
3. Click This Firefox on the left sidebar.
4. Click Load Temporary Add-on...
5. Select the downloaded zip file.

Android:

1. Install Firefox for Android.
2. Download the zip file to your device.
3. In Firefox, go to about:debugging.
4. Enable USB debugging and connect via adb (see Mozilla docs).

🔴 Opera

Download: filtertube-opera-v3.2.2.zip

1. Download and extract the zip file.
2. Go to opera://extensions.
3. Enable Developer mode.
4. Click Load unpacked.
5. Select the extracted folder.

---

Full Changelog: v3.2.1...v3.2.2

FilterTube v3.2.1

What's New in v3.2.1

Performance Optimizations - Lag-Free Processing

• Async DOM Processing: Converted applyDOMFallback() to async with main thread yielding every 30-60 elements, preventing browser freezing during heavy filtering operations.
• Compiled Caching System: Added compiledKeywordRegexCache and compiledChannelFilterIndexCache for O(1) lookups, reducing CPU usage by 60-80%.
• Batched Storage Updates: Channel map updates now batched with 250ms intervals, reducing storage I/O operations by 70-90%.
• Debounced Settings Refresh: Settings updates throttled to prevent excessive DOM reprocessing with 250ms minimum intervals.
• Run State Management: Prevents overlapping DOM processing executions and queues subsequent requests.

Browser Performance Characteristics

• Chromium-based Browsers (Chrome, Edge, Opera): ✅ Excellent performance - lag virtually eliminated (90%+ reduction)
• Firefox-based Browsers: ⚠️ Good improvements but less dramatic, needs ongoing optimization work

Technical Enhancements

• Channel Map Caching: Background script now uses in-memory caching with async flush for better performance.
• Storage Optimization: Reduced storage listener triggers and improved batching logic.
• Error Handling: Enhanced safety checks for non-configurable properties in injector and seed scripts.
• Debug Control: Conditional logging based on window.__filtertubeDebug flag.

Documentation Updates

• ARCHITECTURE.md: Added performance architecture section with Mermaid diagrams showing async processing, caching, and storage batching flows.
• TECHNICAL.md: Comprehensive technical documentation of all performance optimizations with code examples.
• CONTENT_HIDING_PLAYBOOK.md: Updated with DOM fallback processing flow and browser-specific performance notes.
• CODEMAP.md: Enhanced with performance optimization details for each affected file.
• NETWORK_REQUEST_PIPELINE.md: Added performance enhancement context.
• PROACTIVE_CHANNEL_IDENTITY.md: Updated with performance optimization benefits.

---

---

📥 Installation

🌐 Chrome, Brave, Edge (Chromium)

Download: filtertube-chrome-v3.2.1.zip

1. Download and extract the zip file.
2. Open your browser's extensions page (chrome://extensions, brave://extensions, or edge://extensions).
3. Enable Developer mode.
4. Click Load unpacked.
5. Select the extracted folder.

🦊 Firefox (Desktop & Android)

Download: filtertube-firefox-v3.2.1.zip

Desktop:

1. Download the zip file.
2. Go to about:debugging.
3. Click This Firefox on the left sidebar.
4. Click Load Temporary Add-on...
5. Select the downloaded zip file.

Android:

1. Install Firefox for Android.
2. Download the zip file to your device.
3. In Firefox, go to about:debugging.
4. Enable USB debugging and connect via adb (see Mozilla docs).

🔴 Opera

Download: filtertube-opera-v3.2.1.zip

1. Download and extract the zip file.
2. Go to opera://extensions.
3. Enable Developer mode.
4. Click Load unpacked.
5. Select the extracted folder.

---

Full Changelog: v3.2.0...v3.2.1

FilterTube v3.2.0

What's New in v3.2.0

Proactive Channel Identity Architecture

• Zero-delay blocking: 3-dot menus now show correct channel names instantly—no more "Fetching..." delays—thanks to proactive XHR interception that extracts channel identity before rendering.
• Network reduction: Most channel identity comes from intercepted YouTube JSON responses (/youtubei/v1/next, /browse, /player), dramatically reducing the need for separate network fetches.
• Zero-network Kids mode: YouTube Kids works entirely without network fetches, relying only on intercepted JSON for reliable blocking.
• Instant DOM stamping: Channel info is broadcast across worlds and stamped on DOM cards immediately, enabling instant hiding and menu updates.
• Post-block enrichment: Missing metadata (handle, logo, name) is filled in the background at a controlled rate (6-hour cooldown per channel) to avoid spamming YouTube.
• Topic channel handling: Special case for auto-generated Topic channels (e.g., "Music - Topic") that don't have @Handles or custom URLs.

Developer Experience

• New documentation: Added comprehensive docs for the proactive pipeline, including ASCII and Mermaid flow diagrams, surface-by-surface examples, and extension guides.
• Developer guide: Created detailed guide for extending XHR snapshot stashing and renderer extraction.
• Architecture updates: Documented cross-world messaging protocol and snapshot stashing architecture.

Fixes

• Banner regression: Fixed missing "What's New" and refresh banners after extension updates—both now show correctly on open YouTube/Kids tabs.
• Message handlers: Restored background message handlers for release notes and first-run prompts that were accidentally removed.

Documentation

• CHANNEL_BLOCKING_SYSTEM.md: Updated with proactive XHR interception, data source waterfall, and Topic channel details.
• PROACTIVE_CHANNEL_IDENTITY.md: New comprehensive guide explaining the proactive pipeline with ASCII and Mermaid diagrams.
• DEVELOPER_GUIDE.md: New guide for extending FilterTube to support new YouTube features.
• NETWORK_REQUEST_PIPELINE.md: Refactored to reflect XHR-first proactive strategy.
• ARCHITECTURE.md: Updated with cross-world messaging and snapshot stashing details.
• YOUTUBE_KIDS_INTEGRATION.md: Updated for zero-network operation.
• README.md: Added proactive model overview and links to new documentation.
• Website: Updated website for better rediability and listed new features.

---

---

📥 Installation

🌐 Chrome, Brave, Edge (Chromium)

Download: filtertube-chrome-v3.2.0.zip

1. Download and extract the zip file.
2. Open your browser's extensions page (chrome://extensions, brave://extensions, or edge://extensions).
3. Enable Developer mode.
4. Click Load unpacked.
5. Select the extracted folder.

🦊 Firefox (Desktop & Android)

Download: filtertube-firefox-v3.2.0.zip

Desktop:

1. Download the zip file.
2. Go to about:debugging.
3. Click This Firefox on the left sidebar.
4. Click Load Temporary Add-on...
5. Select the downloaded zip file.

Android:

1. Install Firefox for Android.
2. Download the zip file to your device.
3. In Firefox, go to about:debugging.
4. Enable USB debugging and connect via adb (see Mozilla docs).

🔴 Opera

Download: filtertube-opera-v3.2.0.zip

1. Download and extract the zip file.
2. Go to opera://extensions.
3. Enable Developer mode.
4. Click Load unpacked.
5. Select the extracted folder.

---

Full Changelog: v3.1.9...v3.2.0

FilterTube v3.1.9

What's New in v3.1.9

Multi-Profiles, Auto-backup, and PIN Protct

• Auto-backup settings are now profile-aware: mode/format selectors disable when auto-backup is off or the profile is locked, and new profiles inherit auto-backup preferences correctly.
• Auto-backup scheduling triggers on profile creation and mode/format changes only when the active profile has auto-backup enabled, respecting per-profile PIN locks.
• Content-control toggles and auto-backup controls revert and stay disabled when a profile is locked, preventing unauthorized changes.
• Export scope UI enforces “Export active profile only” for non-master profiles; Master can toggle full exports.
• New Tab profile dropdown sits above the lock gate (z-index fix) so it stays clickable even when locked.
• Documentation updated to capture profile/PIN model, profile-scoped backups, and UI gating rules.

---

---

📥 Installation

🌐 Chrome, Brave, Edge (Chromium)

Download: filtertube-chrome-v3.1.9.zip

1. Download and extract the zip file.
2. Open your browser's extensions page (chrome://extensions, brave://extensions, or edge://extensions).
3. Enable Developer mode.
4. Click Load unpacked.
5. Select the extracted folder.

🦊 Firefox (Desktop & Android)

Download: filtertube-firefox-v3.1.9.zip

Desktop:

1. Download the zip file.
2. Go to about:debugging.
3. Click This Firefox on the left sidebar.
4. Click Load Temporary Add-on...
5. Select the downloaded zip file.

Android:

1. Install Firefox for Android.
2. Download the zip file to your device.
3. In Firefox, go to about:debugging.
4. Enable USB debugging and connect via adb (see Mozilla docs).

🔴 Opera

Download: filtertube-opera-v3.1.9.zip

1. Download and extract the zip file.
2. Go to opera://extensions.
3. Enable Developer mode.
4. Click Load unpacked.
5. Select the extracted folder.

---

Full Changelog: v3.1.8...v3.1.9

FilterTube v3.1.8

What's New in v3.1.8

Support + Backups

• Added a new Support page in the dashboard with Ko-fi embed.
• Auto-backups now overwrite a single rolling file: Downloads/FilterTube Backup/FilterTube-Backup-Latest.json.
• Auto-backup download URL handling is now cross-browser:
  • Uses Blob URLs when available.
  • Falls back to data: URLs in Chrome MV3 service worker contexts where URL.createObjectURL is unavailable.

Fixes

• Fixed auto-backup failures in Chrome caused by URL.createObjectURL is not a function.
• Fixed download failures in Firefox caused by data: URL download restrictions.

---

---

📥 Installation

🌐 Chrome, Brave, Edge (Chromium)

Download: filtertube-chrome-v3.1.8.zip

1. Download and extract the zip file.
2. Open your browser's extensions page (chrome://extensions, brave://extensions, or edge://extensions).
3. Enable Developer mode.
4. Click Load unpacked.
5. Select the extracted folder.

🦊 Firefox (Desktop & Android)

Download: filtertube-firefox-v3.1.8.zip

Desktop:

1. Download the zip file.
2. Go to about:debugging.
3. Click This Firefox on the left sidebar.
4. Click Load Temporary Add-on...
5. Select the downloaded zip file.

Android:

1. Install Firefox for Android.
2. Download the zip file to your device.
3. In Firefox, go to about:debugging.
4. Enable USB debugging and connect via adb (see Mozilla docs).

🔴 Opera

Download: filtertube-opera-v3.1.8.zip

1. Download and extract the zip file.
2. Go to opera://extensions.
3. Enable Developer mode.
4. Click Load unpacked.
5. Select the extracted folder.

---

Full Changelog: v3.1.7...v3.1.8

FilterTube v3.1.7

What's New in v3.1.7

YouTube Kids & Backup support

• Added complete Channel & Keyword based blocking on YT Kids it block channels by passive listening to 3 dot menu UI in YT Kids content card i.e. "Block this video" and "Block this channel".
• Added a Settings toggle to enable/disable auto backups.
• Auto backups now save into Downloads/FilterTube Backup/.
• Manual exports now download into Downloads/FilterTube Export/.

Fixes

• Hardened 3-dot menu channel-name labeling on watch Mix cards so Mix metadata strings don't replace channel names.

---

---

📥 Installation

🌐 Chrome, Brave, Edge (Chromium)

Download: filtertube-chrome-v3.1.7.zip

1. Download and extract the zip file.
2. Open your browser's extensions page (chrome://extensions, brave://extensions, or edge://extensions).
3. Enable Developer mode.
4. Click Load unpacked.
5. Select the extracted folder.

🦊 Firefox (Desktop & Android)

Download: filtertube-firefox-v3.1.7.zip

Desktop:

1. Download the zip file.
2. Go to about:debugging.
3. Click This Firefox on the left sidebar.
4. Click Load Temporary Add-on...
5. Select the downloaded zip file.

Android:

1. Install Firefox for Android.
2. Download the zip file to your device.
3. In Firefox, go to about:debugging.
4. Enable USB debugging and connect via adb (see Mozilla docs).

🔴 Opera

Download: filtertube-opera-v3.1.7.zip

1. Download and extract the zip file.
2. Go to opera://extensions.
3. Enable Developer mode.
4. Click Load unpacked.
5. Select the extracted folder.

---

Full Changelog: v3.1.6...v3.1.7

FilterTube v3.1.6

What's New in v3.1.6

Release Notes Experience

• Added a curated “What’s New” tab in the dashboard fed by data/release_notes.json, sharing the same content as the release banner.
• Release banner CTA now routes through the background script and lands inside tab-view.html?view=whatsnew, so no chrome-extension:// links are blocked by content blockers.
• Banner + dashboard documentation now lives in /docs, including UI/UX guidance on when the CTA appears and which fields drive the cards.

Import / Export & Data Portability

• Documented the full import/export pipeline (including c/ChannelName normalization, merge rules, and adapters) with ASCII + Mermaid diagrams.
• js/io_manager.js centralizes sanitization helpers, making merge vs. replace imports reliable for UC IDs, @ handles, and /c/slug values.
• Added contextual comments throughout IO helpers so future schema changes remain self-documented.

---

---

📥 Installation

🌐 Chrome, Brave, Edge (Chromium)

Download: filtertube-chrome-v3.1.6.zip

1. Download and extract the zip file.
2. Open your browser's extensions page (chrome://extensions, brave://extensions, or edge://extensions).
3. Enable Developer mode.
4. Click Load unpacked.
5. Select the extracted folder.

🦊 Firefox (Desktop & Android)

Download: filtertube-firefox-v3.1.6.zip

Desktop:

1. Download the zip file.
2. Go to about:debugging.
3. Click This Firefox on the left sidebar.
4. Click Load Temporary Add-on...
5. Select the downloaded zip file.

Android:

1. Install Firefox for Android.
2. Download the zip file to your device.
3. In Firefox, go to about:debugging.
4. Enable USB debugging and connect via adb (see Mozilla docs).

🔴 Opera

Download: filtertube-opera-v3.1.6.zip

1. Download and extract the zip file.
2. Go to opera://extensions.
3. Enable Developer mode.
4. Click Load unpacked.
5. Select the extracted folder.

---

Full Changelog: v3.1.5...v3.1.6

FilterTube v3.1.5

What's New in v3.1.5

Fixes: Shorts + Members-only (Watch/Sidebar)

• Watch-page sidebar now hides Shorts that are rendered as normal compact videos by checking /shorts/ hrefs, SHORTS overlays, and aria-label hints before cards render.
• Members-only hiding hardened: detects via title aria-labels, badges, and UUMO membership playlists across compact/watch/sidebar/lockup renderers; shelves hide deterministically.
• Members-only toggle now persists correctly (StateManager save/broadcast path and background recompile) so UI selections stick across contexts.

---

---

📥 Installation

🌐 Chrome, Brave, Edge (Chromium)

Download: filtertube-chrome-v3.1.5.zip

1. Download and extract the zip file.
2. Open your browser's extensions page (chrome://extensions, brave://extensions, or edge://extensions).
3. Enable Developer mode.
4. Click Load unpacked.
5. Select the extracted folder.

🦊 Firefox (Desktop & Android)

Download: filtertube-firefox-v3.1.5.zip

Desktop:

1. Download the zip file.
2. Go to about:debugging.
3. Click This Firefox on the left sidebar.
4. Click Load Temporary Add-on...
5. Select the downloaded zip file.

Android:

1. Install Firefox for Android.
2. Download the zip file to your device.
3. In Firefox, go to about:debugging.
4. Enable USB debugging and connect via adb (see Mozilla docs).

🔴 Opera

Download: filtertube-opera-v3.1.5.zip

1. Download and extract the zip file.
2. Go to opera://extensions.
3. Enable Developer mode.
4. Click Load unpacked.
5. Select the extracted folder.

---

Full Changelog: v3.1.4...v3.1.5

FilterTube v3.1.4

What's New in v3.1.4

UI/UX & Responsiveness

• Added mobile-friendly tab view: hamburger nav toggle, overlay, tighter paddings, and responsive grids/inputs for smaller screens.
• Refined filter/search/input rows to wrap gracefully and keep buttons aligned on mobile.
• Tweaked toggle styling (lighter track, crisper borders, centered thumb) for better contrast in light/dark modes.
• Content control cards now use cleaner dividers/hover states and stronger headings while preserving per-group accents.

Playlist/Mix Controls

• Playlist hiding now excludes Mix/Radio items (start_radio=1) while keeping standard playlists hidden.
• Mix/Radio toggle now also hides the “Mixes” chip in the filter bar when enabled.

Note

• UI toggle for “Hide Members-only videos” is temporarily hidden; functionality remains wired for future release.

---

---

📥 Installation

🌐 Chrome, Brave, Edge (Chromium)

Download: filtertube-chrome-v3.1.4.zip

1. Download and extract the zip file.
2. Open your browser's extensions page (chrome://extensions, brave://extensions, or edge://extensions).
3. Enable Developer mode.
4. Click Load unpacked.
5. Select the extracted folder.

🦊 Firefox (Desktop & Android)

Download: filtertube-firefox-v3.1.4.zip

Desktop:

1. Download the zip file.
2. Go to about:debugging.
3. Click This Firefox on the left sidebar.
4. Click Load Temporary Add-on...
5. Select the downloaded zip file.

Android:

1. Install Firefox for Android.
2. Download the zip file to your device.
3. In Firefox, go to about:debugging.
4. Enable USB debugging and connect via adb (see Mozilla docs).

🔴 Opera

Download: filtertube-opera-v3.1.4.zip

1. Download and extract the zip file.
2. Go to opera://extensions.
3. Enable Developer mode.
4. Click Load unpacked.
5. Select the extracted folder.

---

Full Changelog: v3.1.3...v3.1.4

FilterTube v3.1.3

What's New in v3.1.3

UI/UX

• Aligned popup and tab search bars to full-width row sizing; added clearer pill/tooling docs in the Help page with accurate Exact/Comment/Filter All behavior and C/E chip samples.
• Popup content controls hide descriptions for a cleaner view; tab content controls now use title-only tooltips (not row-wide) for descriptions.
• Help legend updated to document badge tints (channel/comment/collab) and pill behaviors with matching colors/shapes.

---

---

📥 Installation

🌐 Chrome, Brave, Edge (Chromium)

Download: filtertube-chrome-v3.1.3.zip

1. Download and extract the zip file.
2. Open your browser's extensions page (chrome://extensions, brave://extensions, or edge://extensions).
3. Enable Developer mode.
4. Click Load unpacked.
5. Select the extracted folder.

🦊 Firefox (Desktop & Android)

Download: filtertube-firefox-v3.1.3.zip

Desktop:

1. Download the zip file.
2. Go to about:debugging.
3. Click This Firefox on the left sidebar.
4. Click Load Temporary Add-on...
5. Select the downloaded zip file.

Android:

1. Install Firefox for Android.
2. Download the zip file to your device.
3. In Firefox, go to about:debugging.
4. Enable USB debugging and connect via adb (see Mozilla docs).

🔴 Opera

Download: filtertube-opera-v3.1.3.zip

1. Download and extract the zip file.
2. Go to opera://extensions.
3. Enable Developer mode.
4. Click Load unpacked.
5. Select the extracted folder.

---

Full Changelog: v3.1.2...v3.1.3