FilterTube v3.3.3

What's New in v3.3.3

Family Device Updates And Protected Profiles

• Managed parent/caregiver controls: parent/account profiles can create and manage protected profiles, edit their rules from the parent dashboard, and send approved policy updates to a verified protected device.
• Family Device Updates: Accounts & Sync now presents the live send path, explicit Home Pickup, and explicit Internet Pickup as one protected-device update model instead of separate technical concepts.
• Saved-update checks: protected profiles check for approved saved updates when the dashboard opens, profile visibility returns, or the profile switches, while still validating trusted link, target profile, scope, revision, and local policy before applying.
• Home Pickup and Internet Pickup hooks: the extension can talk to explicitly configured pickup providers for same-home/school/clinic or away/opens-later delivery. Automatic LAN peer discovery and a hosted FilterTube pickup service are not claimed in this release.
• Two-PIN model clarified: the child/protected profile PIN is for switching into that profile or opening receive-only sync. Parent/account/Master unlock remains the authority for rules, trusted devices, viewing access, time limits, and backups.

Time Limits, Help, And Parent-First UI

• Protected profile time limits: daily YouTube access can be set per protected profile, old and newly opened YouTube tabs are checked, and the timeout screen explains the limit calmly.
• Extra-time request history: protected users can request more time, but that request is recorded for parent review instead of granting authority by itself.
• Parent-first Help refresh: the Help page now starts with plain-language parent flows, explains child profile control, receive-only sync, managed updates, exact keyword matching, date-limited keywords, and rule-list imports.
• Fast help bubbles: key controls across Dashboard, Filters, Settings, Accounts & Sync, profile rows, rule import, time limits, Family Device Updates, and pickup setup now expose short hover/focus/touch help text.
• Accounts & Sync simplification: Family control, Copy once, and Move account flows are described in user terms, with advanced transport and fixed-target options kept behind disclosure.

Rule Lists, Import, And Issue #62 Foundation

• Reviewed rule-list imports: CSV, TXT, simple JSON, BlockTube-style JSON, and raw HTTPS list URLs can be previewed before they add channels or keywords.
• Main/Kids/Both targeting: imported rules can be applied to Main YouTube, YouTube Kids, or both for the current profile/protected profile.
• List management: imported lists can be labeled, paused, resumed, removed, checked for stale URLs, refreshed, and reviewed before refresh changes apply.
• Templates and examples: the import UI exposes CSV and JSON templates plus plain examples so parents can see what a supported file looks like before uploading.
• Catalog boundary: silent public auto-subscribe catalogs are still future governance work. A random public list URL never becomes authority without local review.

Keyword Rules And Comments

• Date-based keyword rules: a keyword can apply only to videos released on/after a date, on/before a date, or between dates.
• Comment date behavior: when a date-limited keyword also filters comments, FilterTube uses the parent video upload/publish date from YouTube metadata rather than pretending each comment has an upload date.
• Date UI validation: date-limited keyword controls no longer activate without the required date for the chosen mode, and single-bound modes only require one date.

YouTube And YTM DOM Compatibility

• Current desktop lockup DOM: title, thumbnail/video id, byline, avatar label, and menu extraction were refreshed for YouTube's camelCase lockup classes such as ytLockupMetadataViewModelTitle and ytLockupViewModelContentImage.
• Current playlist rows: playlist panel rows with ytd-playlist-panel-video-renderer[lockup] and current byline/title structure are inventoried and documented for hide behavior.
• YTM mobile DOM inventory: mobile YouTube now shows camelCase classes such as YtmChipCloudRendererHost, YtmBadgeAndBylineRendererHost, and YtmChannelThumbnailWithLinkRendererHost; the inventory records how these map to existing YTM card filtering.
• Watch chip boundary: Home/Search chip labels can still be filtered where appropriate, but Watch-page related chips on desktop and YTM are treated as navigation refinements, not video cards, so chip changes do not wake DOM fallback or cause Watch scroll jumps.
• Open-tab time-limit enforcement: installed or updated extensions now send managed time-limit checks into already-open YouTube tabs instead of only affecting future tabs.

Release Notes And Boundaries

• Post-3.3.2 audit trail: docs/audit/FILTERTUBE_POST_3_3_2_RELEASE_CHANGELOG_AUDIT_2026-07-02.md records the release lanes from the May 31 v3.3.2 tag to this release prep.
• Native app parity boundary: shared policy contracts and runtime sync expectations are documented, but Android/iOS native UI parity remains a downstream app release lane.
• Known unclaimed work: hosted Internet Pickup deployment, automatic LAN discovery, public list catalog governance, and installed two-device manual smoke evidence remain outside this changelog's completion claim.

---

📥 Installation

🌐 Chrome, Brave, Edge (Chromium)

Download: filtertube-chrome-v3.3.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.3.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.3.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.

Android phone/tablet

Android builds are distributed through Play testing and will be linked from https://filtertube.in/downloads when a public APK is attached to this release.

---

Full Changelog: v3.3.2...v3.3.3

FilterTube v3.3.2

What's New in v3.3.2

Mobile / Tablet App MVP Release Surface

• App MVP release path finalized in the public repo: filtertube.in/downloads, the website platform pages, release tooling, and the extension dashboard now point to the same browser, Android phone/tablet, and iOS/iPad release surface.
• Android phone/tablet release setup: public copy now describes Android as in final testing/release setup with YouTube Main, public YouTube Kids access, profiles, PIN rules, and Nanah sync.
• iOS/iPad release setup: public copy now separates the TestFlight/App Store path from Android and keeps Android TV / Fire TV out of the mobile/tablet release scope.
• Extension dashboard app cards: the dashboard control center now includes Android and iPhone/iPad status cards that route users to the downloads/status hub.
• Release artifacts: build.js can stage Android APK/AAB artifacts and .sha256 checksums beside browser ZIPs when the release is cross-platform.

YouTube Runtime Performance

• Reduced no-rule work: empty or inactive rule states now skip more JSON clone/parse/replay work, DOM fallback scans, quick-block sweeps, fallback menu warmups, and whitelist pending work.
• Whitelist pending throttles: pending-card rechecks are coalesced, batched outside mutation callbacks, capped, and trimmed to the relevant pending cards.
• Overlay-aware observers: fallback menu and quick-block work now backs off while native YouTube menus/overlays are open.
• Production console gate: routine console.log, console.info, and console.debug output is muted in production extension contexts unless explicit FilterTube debug mode is enabled.
• Installed-profile parity gates: release audits now track the difference between private automation Chrome and the real installed user Chrome profile so manual smoke tests run against the extension users actually have installed.

Whitelist / Blocklist Correctness

• Whitelist Shorts creator fallback: whitelisted channel Shorts can use creator-page context when direct card identity is delayed, reducing false hides on allowed channel Shorts tabs.
• Watch autoplay endpoint leaks: compact autoplay/watch-next JSON endpoints are filtered when end-screen card/videowall controls are enabled, including whitelisted-channel watch sessions.
• List-target forwarding: addFilteredChannel now preserves blocklist/whitelist target intent across background paths so UI actions write to the expected list.
• DOM state hardening: runtime state moved away from broad stable data-filtertube-* signatures where possible, reducing externally visible extension fingerprints while preserving necessary local state.

Profiles, Kids, And Nanah

• Managed child authority: child receive-only sync, parent-managed child rule editing, global child edit mode, and locked-profile prompts are now aligned across dashboard surfaces.
• Nanah app metadata: extension/native payloads preserve channel-derived Filter All keyword ownership, row tint, source badges, and pairing metadata across sync/import paths.
• Kids whitelist guard: Kids watch surfaces avoid playlist/watch pause side effects in whitelist mode while still honoring allowed content policy.

Documentation

• Post-April-12 validation register: docs/audit/FILTERTUBE_POST_APRIL_12_RELEASE_DOC_VALIDATION_2026-05-31.md records every commit after the April 12 release baseline and maps code-only commits to current documentation coverage.
• Release-facing docs refreshed: README, release notes JSON, app release workflow docs, website/app release changelog, architecture, technical notes, functionality, and codemap now describe the May 31 release candidate state.
• Known limitation: Android phone/tablet and iOS/iPad should be described as final testing/release setup until public store/direct links are live. Android TV / Fire TV remain future separate app work.

---

📥 Installation

🌐 Chrome, Brave, Edge (Chromium)

Download: filtertube-chrome-v3.3.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.3.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.3.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.

Android phone/tablet

QA debug APK: FilterTube-mobile-tablet-v3.3.2-code30312-debug.apk
Checksum: FilterTube-mobile-tablet-v3.3.2-code30312-debug.apk.sha256
Play/App bundle artifact: FilterTube-mobile-tablet-v3.3.2-code30312-release.aab
The debug APK is attached for QA/direct device validation and must stay clearly marked as QA-only. The AAB is for store upload workflows, not normal sideloading.

---

Full Changelog: v3.3.1...v3.3.2

FilterTube v3.3.1

What's New in v3.3.1

Nanah Device Trust & Sync

• Accounts & Sync simplification: Device Trust & Sync now starts from three simpler paths: Send this profile once, Parent controls child, and Move full account.
• Advanced controls moved behind disclosure: low-level relationship/scope/policy controls are still available, but they are no longer the first thing ordinary users see.
• Remote target profile flow: live sessions can target a specific remote profile more clearly, especially for parent -> child updates.
• Saved managed-link symmetry: when the receiving device saves a managed link on first approval, the sender now stores the matching trusted relationship too.
• Refresh/reconnect clarity: trusted links remain saved, but refresh still ends the live session; reconnect is a fresh live session, not hidden background sync.
• Same-device join protection: self-join/session-burn behavior is blocked more clearly in signaling and the desktop UI.
• Device label persistence: the preferred Nanah device label now survives page refresh.

Parent / Child Safety

• Locked-child parent update path: trusted parent/source links can update child replicas under a saved local child-side rule without sending the PIN.
• Unlocked child rule: unlocked child profiles may send their own scoped snapshot, but not full-account migration.
• Child-surface restriction hardening: child profiles now block more admin/account/import/export/trusted-link mutation paths in desktop UI surfaces.

Documentation

• Nanah user guide added: a plain-language guide now lives in docs/NANAH_USER_GUIDE.md.
• Docs refreshed: README, Architecture, Technical, Functionality, Profiles & PIN, project plan, and the post-implementation concerns tracker now reflect the current Nanah desktop checkpoint.
• Help copy refreshed: the in-product Help page and Accounts & Sync wording now explain the relay as a meeting place and the real payload as device-to-device.

---

📥 Installation

🌐 Chrome, Brave, Edge (Chromium)

Download: filtertube-chrome-v3.3.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.3.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.3.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.3.0...v3.3.1

FilterTube v3.3.0

What's New in v3.3.0

Collaboration + 3-Dot Menu Recovery

• YTM 3-dot/Quick Block rollout: Mobile YouTube home, watch-next, playlist, radio, and Mix-like cards now participate in the same menu/quick-block identity flow instead of falling back to incomplete single-channel handling.
• Watch-page collaboration recovery: Right-rail lockups, watch playlist rows, and watch-like menu surfaces can now recover the full collaborator roster from YouTube's dialog/sheet data instead of stopping at one visible uploader.
• Active menu refresh: If the 3-dot menu opens before collaborator enrichment finishes, the menu can now refresh in place once the full collaborator roster arrives.
• Mix/watch recovery hardening: Mix-like watch rows and fallback popovers now recover owner/collaborator context more consistently through watch-page data.
• False-positive collab guardrails: Plain single-channel names containing & or and no longer become fake collaboration menus unless explicit collaborator evidence exists.
• Optional 3-dot menu item: Added a new content-control toggle so users can hide FilterTube's injected 3-dot menu entry while keeping Quick Block enabled.

Quick Block + Surface Stability

• Quick Block visibility fixes: Hover quick-block now stays above more desktop card overlays and no longer disappears behind complex YouTube surfaces.
• YTM mobile search safety: Quick Block now suppresses itself while mobile search suggestions are open, so it does not interfere with typing/search dropdown interaction.
• Mobile watch-next anchoring: Quick Block now positions more reliably on mobile watch-next cards instead of colliding with compact watch-side layouts.
• Watch/YTM renderer recovery: Restored and expanded YTM renderer handling across DOM extraction and fallback filtering so more mobile cards resolve identity and hide correctly.

Whitelist + Subscriptions Import

• Cross-browser import hardening: Subscribed-channel import now keeps recent real browse responses, prefers active page-driven /feed/channels growth, and handles Chrome/Edge differences more safely.
• /feed/channels exemption: The All subscriptions page is treated as a management surface, so blocked channels remain visible there for audit/import purposes.
• Creator-page whitelist improvements: Whitelist mode handles unresolved cards more safely on creator/channel pages while still respecting page identity.
• YTM whitelist correctness: Additional mobile renderers are now evaluated consistently in whitelist mode, reducing cases where unresolved cards leaked through on YTD/YTM feeds.
• Navigation/filter polish: The subscriptions guide section and the Mixes chip now respect the related hide controls more consistently.

Channel Management + Backups

• Channel Management links: Channel rows can now open the live YouTube channel page using the best available identifier (@handle, UCID, or custom URL).
• Firefox encrypted export fix: Manual encrypted export now uses a safer Firefox fallback path instead of relying only on the downloads API route.

---

📥 Installation

🌐 Chrome, Brave, Edge (Chromium)

Download: filtertube-chrome-v3.3.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.3.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.3.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.2.9...v3.3.0

FilterTube v3.2.9

What's New in v3.2.9

Subscribed Channels Import + Whitelist Flow

• Subscribed channels import: Added a Tab View flow that imports the active YouTube account's subscriptions into whitelist.
• YouTube tab startup hardening: The import now reuses or opens a YouTube tab, routes it to /feed/channels, and waits for the FilterTube bridge before starting.
• Whitelist semantics clarified: Import Only keeps the current blocklist untouched, while Import + Turn On Whitelist follows the existing blocklist-to-whitelist migration behavior.
• Documentation refresh: Added dedicated import docs plus updated architecture, technical, pipeline, renderer, and developer docs for the new flow.

---

📥 Installation

🌐 Chrome, Brave, Edge (Chromium)

Download: filtertube-chrome-v3.2.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.2.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.2.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.2.8...v3.2.9

FilterTube v3.2.8

What's New in v3.2.8

Version 3.2.8

Theme Refresh + Scenic UI Shell Tuning

• Scenic shell refresh: Popup and dashboard surfaces now share the calmer product shell with the local homepage hero video as ambient background media.
• Light + dark theme tuning: Dark mode now keeps the scenic background visible without the washed center glow, while light mode uses cleaner transparency and softer shell opacity.
• Popup UI refinement: The popup was tightened into a quicker control surface with better spacing, improved header balance, clearer enabled/disabled branding, and a more compact profile selector.
• Dashboard shell polish: Top bar, sidebar, cards, and view container were rebalanced to feel more app-like and closer to the website hero direction.

---

📥 Installation

🌐 Chrome, Brave, Edge (Chromium)

Download: filtertube-chrome-v3.2.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.2.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.2.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: https://github.com/varshneydevansh/FilterTube/releases/tag/v3.2.8

FilterTube v3.2.7

What's New in v3.2.7

Category Filters + Quick Block Hover Cross

• Quick Block default ON (one-time migration): showQuickBlockButton now defaults to enabled in v3.2.7, while still allowing users to disable it anytime.
• Safe migration behavior: Added a one-time migration marker (quickBlockDefaultV327Applied) so this default is applied once and not re-forced on future updates.
• Quick block card action hardening: Improved card anchoring and hover lifecycle so the quick cross stays visible on complex YouTube surfaces.
• Search/Home Shorts hover retention fix: Pointer tracking now retains hover state while the pointer remains inside host/anchor bounds, reducing cross disappearance under overlay layers.

Blocking Stability Fixes

• Comment block isolation: Comment-origin block actions are now context-isolated from watch/playlist card logic.
• Playlist autoplay regression fix: Blocking from comment menus no longer triggers unintended playlist row hide/next-video transitions.
• Context-safe identity path: Comment-origin actions skip video-card prefetch/identity merge paths that could leak currently-playing card identity.

Release Notes + What’s New

• v3.2.7 release note refreshed in data/release_notes.json with short, feature-first highlights.

Documentation Updates

• Updated quick-block behavior and reliability notes in:
  • docs/FUNCTIONALITY.md
  • docs/ARCHITECTURE.md
  • docs/CODEMAP.md
• Added README feature note for the quick block cross and updated badge/version metadata.

---

📥 Installation

🌐 Chrome, Brave, Edge (Chromium)

Download: filtertube-chrome-v3.2.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.2.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.2.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.2.6...v3.2.7

FilterTube v3.2.6

What's New in v3.2.6

UI/UX Beautification & Content-Based Filtering

• Typography Overhaul: Complete redesign from serif to modern sans-serif system using Inter font family for improved readability and consistency.
• Font Scale Refinement: Tighter increments (12px-30px) with optimized line heights and letter spacing for better visual hierarchy.
• Content-Based Filters: Three new advanced filtering capabilities:
  • Duration Filter: Hide videos by length (longer/shorter/between specific durations)
  • Upload Date Filter: Filter by publish date (newer/older/between specific dates)
  • Uppercase Filter: Detect and filter clickbait ALL CAPS titles (single_word/all_words/percentage modes)
• videoMetaMap System: Persistent storage of video metadata (duration, publish dates) with intelligent batching (75ms window, 1500 entry cap).
• Enhanced Dropdowns & Selects: 3px left accent borders, floating shadows, improved hover effects, and mobile responsiveness.
• Custom Date Inputs: Styled to match select components with consistent visual language.
• Button Improvements:
  • Import button: Green accent for visual distinction
  • Primary button: Forced white text in dark mode for readability
  • Danger button: Improved contrast (#fca5a5)
• Toggle Switch Refinements: Better dark mode contrast with #e2e8f0 knob color.
• Brand Toggle Button: Visual extension status indicator with enabled/disabled states and 7px uppercase labels.
• Dark Mode Enhancements:
  • Search input: Orange accent highlighting (rgba(217, 119, 6, 0.7))
  • Card boundaries: Consistent #404040 borders across all cards
• Kids Mode Theming: Vibrant pink (#EC4899) and purple (#8B5CF6) gradient design system:
  • Tab navigation with gradient backgrounds
  • Input fields with gradient borders
  • List items with gradient hover effects
  • Sidebar navigation styling
  • Dark mode adaptations with lighter shades
• Dashboard Improvements:
  • Surface-specific stats tracking (separate for Main and Kids)
  • Enhanced stat cards with larger values (2.25rem) and better spacing
  • Donate promo card with gradient styling
• Advance Video Filters Section: Collapsible UI in popup with inline controls and full-width card-style radio options in tab view.

Documentation Updates

• ARCHITECTURE.md: Added videoMetaMap extraction flow, content filters architecture, and fixed broken mermaid diagram.
• TECHNICAL.md: Comprehensive typography system documentation and UI component styling guide (~800 lines).
• FUNCTIONALITY.md: Complete content filters documentation with examples and use cases (~450 lines).
• YOUTUBE_KIDS_INTEGRATION.md: Kids Mode theming documentation with accessibility considerations (~200 lines).
• CODEMAP.md: Updated to v3.2.5 with feature overview.
• README.md: Added content-based filters to features list.

---

📥 Installation

🌐 Chrome, Brave, Edge (Chromium)

Download: filtertube-chrome-v3.2.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.2.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.2.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.2.5...v3.2.6

FilterTube v3.2.5

What's New in v3.2.5

Whitelist Mode Promoted + Stability

• Promoted Whitelist Mode: Removed experimental labels; whitelist mode is now the primary allow-only path.
• 3-Dot Menu Cleanup: Disabled irrelevant "Block Channel" menus in whitelist mode to prevent user confusion.
• Search Secondary Handling: Added intelligent processing for right-rail watch cards on search pages.
• Enhanced Channel Extraction: Multi-source identity resolution with thumbnail anchors and parent containers.
• Mode-Aware State Tracking: Seamless switching between blocklist/whitelist with intelligent reprocessing.
• Bridge-Level Optimizations: Excluded search results from whitelist pending logic for better performance.
• UI Confirmation Dialogs: Added user confirmation when switching modes with intelligent transfer options.
• Seed.js Intelligence: Mode-aware search processing that skips unnecessary engine work in whitelist mode.
• Kids Mode Whitelist Support: Extended whitelist functionality to YouTube Kids profiles with zero-network architecture.
• Filter Logic Enhancements: Added chip renderer exclusion and watch page scaffolding protection.
• Playlist Stability: Selected rows stay visible; pending identities no longer unhide blocked rows.
• Performance Improvements: Selective processing and bridge-level exclusions reduce CPU usage.

---

📥 Installation

🌐 Chrome, Brave, Edge (Chromium)

Download: filtertube-chrome-v3.2.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.2.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.2.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.2.4...v3.2.5

FilterTube v3.2.4

What's New in v3.2.4

Enhanced Whitelist Mode (Experimental)

• 3-Dot Menu Cleanup: Disabled irrelevant "Block Channel" menus in whitelist mode to prevent user confusion and improve interface clarity.
• Search Secondary Handling: Added intelligent processing for right-rail watch cards on search pages, preventing UI clutter in whitelist mode.
• Enhanced Channel Extraction: Improved multi-source channel identity resolution with thumbnail anchors and parent container data extraction.
• Mode-Aware State Tracking: Implemented seamless switching between blocklist/whitelist modes with intelligent reprocessing and state management.
• Bridge-Level Optimizations: Excluded search results from whitelist pending logic for better performance and reduced CPU usage.
• UI Confirmation Dialogs: Added user confirmation when switching modes to prevent accidental data loss, with intelligent transfer options.
• Seed.js Intelligence: Mode-aware search processing that skips unnecessary engine work in whitelist mode for better performance.
• Kids Mode Whitelist Support: Extended whitelist functionality to YouTube Kids profiles with zero-network architecture.
• Filter Logic Enhancements: Added chip renderer exclusion and watch page scaffolding protection for cleaner content filtering.

Technical Improvements

• Performance Optimizations: Selective processing and bridge-level exclusions improve overall extension performance.
• Enhanced Error Handling: Better fallback mechanisms for edge cases in whitelist mode processing.
• State Management: Improved mode switching state tracking prevents unnecessary DOM reprocessing.

---

📥 Installation

🌐 Chrome, Brave, Edge (Chromium)

Download: filtertube-chrome-v3.2.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.2.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.2.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.2.3...v3.2.4