release_notes.json

[
  {
    "_comment": "Shared release notes source for the dashboard What's New tab and the YouTube release banner. Keep entries sorted newest-first by version."
  },
  {
    "version": "3.3.2",
    "headline": "Upcoming: watch identity, Nanah sync, and app parity cleanup",
    "summary": "Prepared release notes for the next checkpoint without bumping the packaged extension version yet: watch/player playlist identity is more reliable, first-save channel rows preserve real names and alternate IDs, Nanah app sync keeps channel-derived keyword ownership, and several UI/performance regressions are guarded.",
    "bannerSummary": "Watch identity repairs, safer first-save channel rows, Nanah app-sync metadata preservation, and UI/performance regression guards are staged for the next release.",
    "highlights": [
      "Watch/player playlist blocks keep stored video-to-channel mappings authoritative while still recovering handles, custom URLs, names, and logos when YouTube exposes them later.",
      "First-save channel rows no longer treat a bare @handle as a complete display name, reducing backup snapshots with temporary handle-as-name rows.",
      "Search SPA collaborator recovery keeps recent YouTube search response snapshots so collaborator menus can still upgrade after watch-to-search navigation.",
      "Tablet Shorts cards and mobile watch-page Shorts tiles now use a Shorts-specific `shorts:<videoId>` resolver path, so 3-dot blocks and Quick Cross blocks recover the correct channel instead of failing through the watch resolver.",
      "Nanah/import paths preserve channel-derived Filter All keyword ownership between extension and native app payloads, including row color and source-badge metadata.",
      "Quick Block hover controls clip against sticky YouTube chrome and keep their hover state across preview overlays without punching into top UI.",
      "Firefox/Waterfox manual export, system-theme first paint, short-height sidebar scrolling, large-blocklist indexed matching, duplicate init debug gating, and channel-row no-redraw behavior are part of this checkpoint."
    ]
  },
  {
    "version": "3.3.1",
    "headline": "Sync Across devices securely via p2p with no 3rd part server",
    "summary": "Accounts & Sync now presents Nanah as three simpler paths, with stronger parent/child targeting, clearer reconnect rules, and much broader documentation for real-world use.",
    "bannerSummary": "Nanah sync, better parent/child control, safer reconnect rules, and full docs for the new Accounts & Sync flow.",
    "highlights": [
      "Accounts & Sync now starts with three clearer paths: Send this profile once, Parent controls child, and Move full account.",
      "Advanced Nanah controls are still available, but they are hidden behind an Advanced section instead of leading the whole flow.",
      "Parent/source sessions can choose a remote target profile more clearly, and managed-link saves now mirror to the sender so both devices keep the same trust record.",
      "Trusted links remain saved across refresh, but reconnect is still a fresh live session rather than hidden background sync.",
      "Locked child updates, reconnect rules, device-label persistence, and self-join/session-burn protection were tightened for safer parent control.",
      "README, Architecture, Technical, Functionality, Profiles & PIN, project plan, user guide, and the concern tracker now document the current Nanah desktop checkpoint in much more detail."
    ],
    "detailsUrl": "https://github.com/varshneydevansh/FilterTube/releases/tag/v3.3.1"
  },
  {
    "version": "3.3.0",
    "headline": "Collaboration recovery + cross-browser import hardening",
    "summary": "Watch/YTM collaboration menus recover full rosters more reliably, subscriptions import is stronger across browsers, and several surface-specific whitelist and Quick Block fixes are now bundled into 3.3.0.",
    "bannerSummary": "Better collab menus, stronger whitelist import, safer Quick Block surfaces, direct channel links, and a new toggle for the 3-dot block item.",
    "highlights": [
      "Mobile YouTube home/watch-next/Mix-style cards now participate in the same 3-dot and collaborator recovery flow instead of falling back to incomplete single-channel menus.",
      "Watch-page right rail, playlist rows, and watch-like lockups can now recover the full collaborator roster and refresh the active 3-dot menu in place.",
      "Mix/watch recovery is safer: real collaboration cards upgrade properly, while plain names containing '&' or 'and' no longer become false collaboration menus.",
      "Quick Block is more stable across complex surfaces: it stays above more desktop cards, avoids mobile search-suggestion dropdowns, and anchors better on mobile watch-next layouts.",
      "Subscribed-channel whitelist import now keeps recent page browse responses, prefers real /feed/channels growth, and preserves /feed/channels as a visible management surface.",
      "Whitelist filtering is stricter and safer across YouTube desktop/mobile renderers, including better creator-page handling and improved Mixes/subscriptions hide controls.",
      "New controls and polish: Channel Management rows link to real channel pages, the 3-dot block item can be disabled, and encrypted Firefox export uses a safer fallback path."
    ],
    "detailsUrl": "https://github.com/varshneydevansh/FilterTube/releases/tag/v3.3.0"
  },
  {
    "version": "3.2.9",
    "headline": "Subscribed Channels Import + Whitelist + PIN protection bug fix",
    "summary": "Import the active YouTube account's subscriptions into whitelist with clearer mode-switch semantics and a more reliable /feed/channels startup flow.",
    "bannerSummary": "Build whitelist from your current YouTube subscriptions with inline progress and clearer whitelist activation behavior.",
    "highlights": [
      "New Tab View import: subscribed channels can be imported from the active signed-in YouTube account into whitelist.",
      "Import startup now reuses a live YouTube tab, routes it to /feed/channels, and waits for the FilterTube bridge before starting.",
      "Whitelist copy is clearer: Import Only leaves the blocklist untouched, while Import + Turn On Whitelist follows the existing blocklist-to-whitelist migration path.",
      "Documentation now covers the import architecture, FEchannels request flow, renderer sources, and whitelist semantics in much more detail."
    ],
    "detailsUrl": "https://github.com/varshneydevansh/FilterTube/releases/tag/v3.2.9"
  },
  {
    "version": "3.2.8",
    "headline": "Theme Refresh + Scenic UI Shell Tuning",
    "summary": "Popup and dashboard surfaces now use the calmer scenic theme system with tighter layout, stronger tint states, and better light/dark balance.",
    "bannerSummary": "Refined popup + dashboard theme with calmer transparency, stronger pills, and better responsive layout behavior.",
    "highlights": [
      "Scenic UI refresh: popup and dashboard now share the calmer product shell with the local hero video as ambient background media.",
      "Light and dark theme tuning: darker mode keeps the scenic background visible without the washed center glow, while light mode uses cleaner transparency.",
      "Responsive cleanup: tighter popup spacing, smaller profile dropdown, better Help/Support card layout, and improved mobile fit across filter surfaces.",
      "Control tint fixes: enabled/disabled states, pill colors, search fields, and import/export actions now read more clearly across both themes."
    ],
    "detailsUrl": "https://github.com/varshneydevansh/FilterTube/releases/tag/v3.2.8"
  },
  {
    "version": "3.2.7",
    "headline": "Category Filters + Quick Block Hover Cross + Mobile 3 Dot UI & Quick Cross Block Support",
    "summary": "New category filtering, one-tap quick cross block enabled by default",
    "bannerSummary": "Use new category filters and quick cross block from card hover; and better support for YT Mobile blocking.",
    "highlights": [
      "Category Filtering: Block or allow videos by YouTube category (Music, Gaming, Education, etc.)",
      "Quick Cross Block Default ON: `Show Quick Cross Block button` is enabled by default in v3.2.7 (users can still disable it)",
      "Mobile Blocking: Better support for YT Mobile blocking for 3 Dot UI & Quick Cross Block currently working on Home Page"
    ],
    "detailsUrl": "https://github.com/varshneydevansh/FilterTube/releases/tag/v3.2.7"
  },
  {
    "version": "3.2.6",
    "headline": "UI/UX Beautification & Content-Based Filtering",
    "summary": "Complete typography improvements with modern design, three new content filters (duration, date, uppercase).",
    "bannerSummary": "Beautiful new UI with content filters for duration, upload date, and clickbait detection.",
    "highlights": [
      "Typography updates: Modern and refined font scale for better readability",
      "Content-based filters: Duration (longer/shorter/between), upload date (newer/older/between), and uppercase detection (clickbait titles)",
      "videoMetaMap system: Persistent video metadata storage with intelligent batching (75ms window, 1500 entry cap)",
      "Dashboard improvements: Surface-specific stats (Main vs Kids), enhanced stat cards, donate promo card"
    ],
    "detailsUrl": "https://github.com/varshneydevansh/FilterTube/releases/tag/v3.2.6"
  },
  {
    "version": "3.2.5",
    "headline": "Whitelist Mode Promoted + Stability",
    "summary": "Whitelist mode is now the primary allow-only path with smarter extraction, playlist safeguards, and reduced CPU usage.",
    "bannerSummary": "Whitelist mode promoted with cleaner UI, better playlist stability, and Kids support.",
    "highlights": [
      "Promoted whitelist mode: wording/UI no longer marked experimental",
      "3-dot menu cleanup and search-secondary handling for whitelist surfaces",
      "Multi-source channel extraction with thumbnail anchors and parent containers",
      "Mode-aware state tracking with confirmation dialogs and bridge optimizations",
      "Playlist stability: selected rows stay visible; pending identities no longer unhide blocked rows",
      "Kids mode whitelist support with zero-network architecture"
    ],
    "detailsUrl": "https://github.com/varshneydevansh/FilterTube/releases/tag/v3.2.5"
  },
  {
    "version": "3.2.4",
    "headline": "Enhanced Whitelist Mode + Performance Optimizations",
    "summary": "Significant improvements to experimental whitelist mode with better UX, performance optimizations, and extended Kids mode support.",
    "bannerSummary": "Whitelist mode gets smarter with cleaner UI, better performance, and Kids support.",
    "highlights": [
      "EXPERIMENTAL: Enhanced whitelist mode with 3-dot menu cleanup, intelligent search processing, and mode-aware state tracking",
      "Performance boost: Bridge-level optimizations and selective processing reduce CPU usage",
      "UI improvements: Confirmation dialogs prevent accidental data loss when switching modes",
      "Kids mode support: Whitelist functionality now works on YouTube Kids with zero-network architecture",
      "Search optimizations: Right-rail watch cards handled intelligently to prevent UI clutter",
      "Channel extraction: Multi-source identity resolution with thumbnail anchors and parent containers",
      "Mode switching: Seamless transitions between blocklist/whitelist with intelligent reprocessing"
    ],
    "detailsUrl": "https://github.com/varshneydevansh/FilterTube/releases/tag/v3.2.4"
  },
  {
    "version": "3.2.3",
    "headline": "Experimental Whitelist Mode + UI Improvements",
    "summary": "Alpha release of whitelist mode for 'allow-only' filtering, plus enhanced UI updates and mobile menu support.",
    "bannerSummary": "Try experimental whitelist mode - hide everything except allowed channels.",
    "highlights": [
      "EXPERIMENTAL: Whitelist mode hides all content except explicitly allowed channels/keywords",
      "Dual filtering modes with easy toggle between blocklist and whitelist in popup and tab view",
      "Staging migration - switch to blocklist to collect channels, then merge back to whitelist",
      "Watch page protection in whitelist mode maintains video playback functionality",
      "Optimistic UI updates hide content instantly with automatic restoration if blocking fails",
      "Enhanced mobile menu support with proper YouTube mobile renderer handling",
      "All console logs now gated behind debug flag to reduce production noise"
    ],
    "detailsUrl": "https://github.com/varshneydevansh/FilterTube/releases/tag/v3.2.3"
  },
  {
    "version": "3.2.2",
    "headline": "UI/UX Improvements & Debug Gating",
    "summary": "Optimistic updates, mobile menu support, debug-gated logging, scroll preservation, and state management refinements.",
    "bannerSummary": "Instant UI feedback, mobile menu polish, and debug-gated logs with stable state handling.",
    "highlights": [
      "Optimistic UI updates: content hides instantly with auto-restore if blocking fails",
      "Enhanced mobile menu support for ytm-menu-popup-renderer with correct renderer tags",
      "Debug-gated logging via window.__filtertubeDebug",
      "Scroll preservation during DOM fallback to prevent jarring jumps",
      "Channel enrichment limits (10 per session) to reduce background requests",
      "Idle-scheduled rendering with requestIdleCallback and batching",
      "External reload debouncing with signature comparison to avoid redundant renders",
      "Selective notifications: 'load' only on signature change; otherwise 'externalUpdate'",
      "Bridge state management via shared global state"
    ],
    "detailsUrl": "https://github.com/varshneydevansh/FilterTube/releases/tag/v3.2.2"
  },
  {
    "version": "3.2.1",
    "headline": "Lag-Free Processing + Performance Boost",
    "summary": "Major performance optimizations eliminate UI lag, with excellent results in Chromium browsers and significant improvements in Firefox.",
    "bannerSummary": "Lag-free filtering with async processing, compiled caching, and batched updates.",
    "highlights": [
      "Async DOM processing with main thread yielding prevents browser freezing during heavy filtering.",
      "Compiled regex and channel filter caching provides O(1) lookups, reducing CPU usage by 60-80%.",
      "Batched storage updates reduce I/O operations by 70-90% with intelligent 250ms intervals.",
      "Debounced settings refresh prevents excessive DOM reprocessing.",
      "Run state management prevents overlapping executions and queues requests properly.",
      "Chromium browsers: 90%+ lag reduction; Firefox: significant improvements with ongoing optimization."
    ],
    "detailsUrl": "https://github.com/varshneydevansh/FilterTube/releases/tag/v3.2.1"
  },
  {
    "version": "3.2.0",
    "headline": "Instant blocking + zero-network Kids",
    "summary": "3-dot menus show channel names instantly, network requests drop dramatically, and YouTube Kids works entirely offline.",
    "bannerSummary": "Zero-delay blocking with proactive XHR interception; Kids mode works without any network fetches.",
    "highlights": [
      "3-dot menus now show correct channel names instantly—no more 'Fetching...' delays.",
      "Channel identity comes from intercepted YouTube JSON responses, reducing network calls.",
      "YouTube Kids works entirely without network fetches for reliable blocking.",
      "Missing metadata fills in the background at a controlled rate (6-hour cooldown).",
      "Topic channels (e.g., 'Music - Topic') handled specially without @handles.",
      "New comprehensive documentation with ASCII and Mermaid flow diagrams."
    ],
    "detailsUrl": "https://github.com/varshneydevansh/FilterTube/releases/tag/v3.2.0"
  },
  {
    "version": "3.1.9",
    "headline": "Profile-aware backups + lock-gated controls",
    "summary": "Auto-backup and content controls now respect profile locks/PINs, inherit per-profile settings, and the profile dropdown stays clickable over the lock gate.",
    "bannerSummary": "Per-profile auto-backup + locked-profile gating; profile selector is always clickable.",
    "highlights": [
      "Auto-backup mode/format selectors disable when auto-backup is off or the profile is locked; new profiles inherit auto-backup preferences.",
      "Auto-backup scheduling now triggers on profile creation and mode/format changes only when auto-backup is enabled for that profile.",
      "Content-control toggles and backup controls stay disabled/revert when locked; export scope forces active-profile-only for non-master profiles.",
      "Profile dropdown z-index fix keeps it clickable even when the lock gate banner is visible.",
      "Docs updated for profile/PIN model, profile-scoped backups, and UI gating rules."
    ],
    "detailsUrl": "https://github.com/varshneydevansh/FilterTube/releases/tag/v3.1.9"
  },
  {
    "version": "3.1.8",
    "headline": "Support tab + reliable auto-backups",
    "summary": "New Support page (Ko-fi) and auto-backups now work reliably on both Chrome and Firefox.",
    "bannerSummary": "Auto-backups are now cross-browser and overwrite a single latest backup file.",
    "highlights": [
      "Added a Support page in the dashboard with Ko-fi embed.",
      "Auto-backups now overwrite a single rolling file: Downloads/FilterTube Backup/FilterTube-Backup-Latest.json.",
      "Download strategy is cross-browser (Blob URL when available; data: URL fallback for Chrome MV3 service worker).",
      "Firefox downloads no longer fail due to data: URL restrictions."
    ],
    "detailsUrl": "https://github.com/varshneydevansh/FilterTube/releases/tag/v3.1.8"
  },
  {
    "version": "3.1.7",
    "headline": "YT Kids + Auto-backup support",
    "summary": "Block channel based content on YT Kids & Auto backups can now be toggled on/off",
    "bannerSummary": "New setting: enable/disable auto backups. Exports now save into Downloads/FilterTube Export/.",
    "highlights": [
      "Added complete Channel & Keyword based blocking on YT Kids it block channels by passive listening to 3 dot menu UI in YT Kids",
      "Added a Settings toggle to enable/disable auto backups (best-effort; no Save As prompts).",
      "Auto backups save into Downloads/FilterTube Backup/ with rotation (latest files kept).",
      "Manual exports now download silently into Downloads/FilterTube Export/."
    ],
    "detailsUrl": "https://github.com/varshneydevansh/FilterTube/releases/tag/v3.1.7"
  },
  {
    "version": "3.1.6",
    "headline": "Import/Export support + Release banner",
    "summary": "Banner CTA now deep-links into the What’s New dashboard, curated cards load from the same JSON, and imports better honor c/ChannelName + merge rules.",
    "bannerSummary": "Release banner opens the in-extension What’s New tab and import/export now documents the full flow.",
    "highlights": [
      "Release notes JSON hydrates both the dashboard cards and the YouTube banner (single source of truth).",
      "CTA opens tab-view via background messaging so blockers never intercept chrome-extension:// links.",
      "Import/export doc + code clarify how UC/handle/c/ChannelName inputs normalize before merging."
    ],
    "detailsUrl": "https://github.com/varshneydevansh/FilterTube/releases/tag/v3.1.6"
  },
  {
    "version": "3.1.5",
    "headline": "Shorts + Members-only are actually gone",
    "summary": "Watch page + sidebar now hide Shorts renderers and members-only shelves before they flash, and the toggle state finally sticks.",
    "bannerSummary": "Members-only + Shorts hiding hardened across watch and sidebar so blocked rows stop resurfacing.",
    "highlights": [
      "Sidebar checks /shorts/ hrefs, overlays, and aria-labels before cards render.",
      "Members-only detection covers compact, watch, and shelf rows with new badges + playlist heuristics.",
      "Members-only toggle persistence bug fixed so state survives reloads."
    ],
    "detailsUrl": "https://github.com/varshneydevansh/FilterTube/releases/tag/v3.1.5"
  },
  {
    "version": "3.1.4",
    "headline": "Dashboard goes responsive",
    "summary": "Navigation collapses cleanly on mobile, inputs wrap gracefully, and playlist/mix controls get clearer toggles.",
    "highlights": [
      "Hamburger nav + overlay for small screens with refined grid spacing.",
      "Toggles get lighter tracks, centered thumbs, and better dark-mode contrast.",
      "Mix/Radio chip hides when Mix toggle is on; playlist hiding skips radio items."
    ],
    "detailsUrl": "https://github.com/varshneydevansh/FilterTube/releases/tag/v3.1.4"
  },
  {
    "version": "3.1.3",
    "headline": "Help legend makeover",
    "summary": "Cards, pills, and tooltips document exactly what Exact / Comment / Filter All do, matching the refreshed dashboard styling.",
    "highlights": [
      "Help tab shows badge tints and collaboration labels with matching colors.",
      "Popup + tab search bars align to the same full-width rhythm.",
      "Content control descriptions move into hover tooltips for clarity."
    ],
    "detailsUrl": "https://github.com/varshneydevansh/FilterTube/releases/tag/v3.1.3"
  },
  {
    "version": "3.1.2",
    "headline": "Playlist autoplay hardening",
    "summary": "Autoplay now leaps past blocked playlist rows without flashing them, and sticky hiding survives YouTube reprocessing.",
    "highlights": [
      "Next-click only fires when the next playlist row is actually visible.",
      "Watch playlist panel rows stay hidden even if identity is briefly unresolved.",
      "3-dot menu closes cleanly after blocking so the miniplayer keeps playing."
    ],
    "detailsUrl": "https://github.com/varshneydevansh/FilterTube/commit/1224715a84c48ee6d3ddd93b13cc62e487574a31"
  },
  {
    "version": "3.1.1",
    "headline": "Help tab + identity fixes",
    "summary": "A dedicated Help tab lands in the dashboard while UC ↔ handle ↔ custom URL mapping gets more resilient.",
    "highlights": [
      "Help reference documents all toggles, badges, and keyword behaviors.",
      "Playlist navigation skips blocked rows without playback flashes.",
      "Handle/custom URL fallback locks onto the correct UC ID more reliably."
    ],
    "detailsUrl": "https://github.com/varshneydevansh/FilterTube/commit/1b2e442831a40c52148bc9ff830c70c2e6aa909c"
  },
  {
    "version": "3.1.0",
    "headline": "Docs + hybrid filtering clarity",
    "summary": "Captured the hybrid interception + DOM fallback architecture with diagrams so you know how FilterTube enforces blocks.",
    "highlights": [
      "Documented watch-page 3-dot parity with home/search collaborators.",
      "Catalogued outstanding playlist regressions so fixes stay visible.",
      "Synced manifests, build tooling, and UI footer with the 3.1.0 bump."
    ],
    "detailsUrl": "https://github.com/varshneydevansh/FilterTube/commit/076baa2ecb14a3e8f5bdf420caa1af7096548f15"
  }
]