BUMP: v3.1.7 YT Kids support & Auto Backup

Author: varshneydevansh

CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## Version 3.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.
+
+---
+
 ## Version 3.1.6
 
 ### Release Notes Experience
@@ -72,52 +87,69 @@
 ## Version 3.1.1
 
 ### Watch Page (Playlists)
+
 - Watch-page playlist panel rows now hide deterministically for blocked channels (playlist items are enriched via `videoChannelMap`).
 - Next/Prev navigation skips blocked playlist items without visible playback flash.
 
 ### UI
+
 - Added a Help section in the dashboard (new tab UI) documenting all features/toggles.
 
 ### Identity & Robustness
+
 - Improved channel identity convergence (handle/customUrl ↔ UC ID mapping) so blocking is resilient to `/@handle/about` failures.
 
 ---
 
 ## Version 3.1.0
 
 ### Watch Page & Docs
+
 - Documented that watch-page 3-dot menus now mirror Home/Search collaborator behavior and clarified the remaining single-channel label gap plus Shorts coverage (`docs/home_watch_collab_plan.md`, `docs/CHANNEL_BLOCKING_SYSTEM.md`, `docs/youtube_renderer_inventory.md`).
 - Captured the outstanding playlist/mix regression (hidden rows reappearing after hard refresh) so it stays visible in watch-page plans.
 
 ### Misc
+
 - Version bump to keep manifests, build tooling, and UI footer aligned with the new release.
 
+---
+
 ## Version 3.0.9
 
 ### Refactor
+
 - **3-dot menu module split**: Moved the dropdown observer/bootstrap logic into `js/content/block_channel.js` (loaded before `content_bridge.js`).
 
 ### Cleanup
+
 - **Legacy observer removal**: Removed the old/disabled dropdown observer code from `content_bridge.js` after validating the new `block_channel.js` entry-point.
 
 ### Documentation
+
 - Updated docs to reflect the new isolated-world module structure + load order.
 - Expanded `docs/youtube_renderer_inventory.md` with additional menu DOM variants used by the 3-dot injection pipeline.
 
+---
+
 ## Version 3.0.8
 
 ### Channel Blocking Hardening
+
 - **404 Recovery Pipeline**: Added a four-layer strategy (cache-first lookup, ytInitialData replay, Shorts helpers, DOM cache reset) so blocking always resolves a UC ID even when `/@handle/about` fails.
 
 - **DOM Reprocessing**: Cards now re-run the fallback when their `data-filtertube-last-processed-id` changes, preventing stale metadata from skipping new videos.
 
 ### Documentation
+
 - Added `docs/handle-404-remediation.md` playbook and updated architecture/tech docs to reflect the new recovery flow.
 - Expanded `CONTENT_HIDING_PLAYBOOK.md` and `CHANNEL_BLOCKING_SYSTEM.md` with channel identity guidance for Shorts/home surfaces.
 
+---
+
 ## Version 3.0.7
 
 ### New Features
+
 - **Posts Support**: Added proper channel extraction for YouTube community posts
   - "Block Channel" menu now works correctly on posts via 3-dot menu
   - Extracts channel info from post author links and thumbnails

data/release_notes.json

@@ -2,6 +2,19 @@
   {
     "_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.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",

docs/ARCHITECTURE.md

@@ -1,8 +1,8 @@
-# FilterTube v3.1.6 Architecture Documentation
+# FilterTube v3.1.7 Architecture Documentation
 
 ## Executive Summary
 
-FilterTube v3.1.6 implements a robust **Hybrid Filtering Architecture** that combines preemptive **Data Interception (Main World)** with a resilient **DOM Fallback (Isolated World)**. This dual-layer approach ensures comprehensive content filtering across all YouTube surfaces (Home, Search, Watch, Shorts) while maintaining high performance and a "Zero Flash" user experience when YouTube routes content through JSON.
+FilterTube v3.1.7 implements a robust **Hybrid Filtering Architecture** that combines preemptive **Data Interception (Main World)** with a resilient **DOM Fallback (Isolated World)**. This dual-layer approach ensures comprehensive content filtering across all YouTube surfaces (Home, Search, Watch, Shorts) while maintaining high performance and a "Zero Flash" user experience when YouTube routes content through JSON.
 
 ## Architecture Overview
 

docs/CHANNEL_BLOCKING_SYSTEM.md

@@ -1,4 +1,4 @@
-# Channel Blocking System (v3.1.6)
+# Channel Blocking System (v3.1.7)
 
 ## 0. Goal & Non-Goals
 
@@ -132,7 +132,7 @@ This is most reliable "no-network" source when YouTube supplies browse endpoint.
 - It calls `content_bridge.js:injectFilterTubeMenuItem(dropdown, videoCard)` to render "Block channel" menu entry.
 - On click, `content_bridge.js:handleBlockChannelClick(channelInfo, ...)` runs.
 
-### 4.2 Identity resolution pipeline (v3.1.6 enhanced)
+### 4.2 Identity resolution pipeline (v3.1.7 enhanced)
 
 #### Initial extraction (synchronous):
 ```javascript
@@ -233,7 +233,7 @@ DOM fallback must be careful about:
 - Separate storage namespace (`ftProfilesV3.kids`)
 - DOM fallback uses videoChannelMap mappings from Kids browse/search
 
-### 5.4 3-Dot Menu Label Resolution (v3.1.6)
+### 5.4 3-Dot Menu Label Resolution (v3.1.7)
 
 The 3-dot menu now intelligently upgrades placeholder labels to real channel names:
 

docs/NETWORK_REQUEST_PIPELINE.md

@@ -2,7 +2,7 @@
 
 ## Overview
 
-FilterTube v3.1.6 implements a sophisticated network request pipeline for channel identity resolution across both YouTube Main and YouTube Kids domains. This pipeline ensures accurate channel information is available for 3-dot menu labels and blocking actions.
+FilterTube v3.1.7 implements a sophisticated network request pipeline for channel identity resolution across both YouTube Main and YouTube Kids domains. This pipeline ensures accurate channel information is available for 3-dot menu labels and blocking actions.
 
 ## Architecture
 

docs/TECHNICAL.md

@@ -1,6 +1,6 @@
-# FilterTube v3.1.6 Technical Documentation
+# FilterTube v3.1.7 Technical Documentation
 
-This document provides a deep technical dive into implementation of FilterTube's hybrid filtering engine as of v3.1.6.
+This document provides a deep technical dive into implementation of FilterTube's hybrid filtering engine as of v3.1.7.
 
 ## Core Technologies
 

docs/THREE_DOT_MENU_IMPROVEMENTS.md

@@ -2,11 +2,11 @@
 
 ## Overview
 
-FilterTube v3.1.6 significantly improves the 3-dot menu experience across YouTube Main and YouTube Kids, ensuring accurate channel names are displayed and blocking actions work reliably for Shorts, Mixes, Playlists, and Watch page videos.
+FilterTube v3.1.7 significantly improves the 3-dot menu experience across YouTube Main and YouTube Kids, ensuring accurate channel names are displayed and blocking actions work reliably for Shorts, Mixes, Playlists, and Watch page videos.
 
 ## Problem Statement
 
-Prior to v3.1.6, users experienced:
+Prior to v3.1.7, users experienced:
 1. **UC IDs displayed**: 3-dot menu showed `UCxxxxxxxx...` instead of human-readable channel names
 2. **Mix titles as channel names**: Mix/playlist cards showed video titles instead of actual channel names
 3. **Metadata strings as names**: Watch right-pane showed strings like "Title • 1.2M views • 2 days ago"
@@ -379,7 +379,7 @@ Track label resolution performance:
 
 ### From Previous Versions
 
-Users upgrading to v3.1.6 will see:
+Users upgrading to v3.1.7 will see:
 - Immediate improvement in Mix/playlist label accuracy
 - Better Shorts channel name resolution
 - More consistent behavior across all surfaces

docs/YOUTUBE_KIDS_INTEGRATION.md

@@ -2,13 +2,13 @@
 
 ## Overview
 
-FilterTube v3.1.6 introduces native integration with YouTube Kids, allowing users to block channels directly from Kids UI while maintaining the same filtering power available on YouTube Main.
+FilterTube v3.1.7 introduces native integration with YouTube Kids, allowing users to block channels directly from Kids UI while maintaining the same filtering power available on YouTube Main.
 
 ## Architecture
 
 ### Dual-Profile System
 
-```
+```text
 ┌─────────────────────────────────────────────────────────────────────┐
 │                    FilterTube Extension                             │
 ├─────────────────────────────────────────────────────────────────────┤
@@ -289,15 +289,15 @@ function enqueueVideoChannelMapUpdate(videoId, channelId) {
 
 ### CORS Limitations
 
-YouTube Kids blocks cross-origin requests from www.youtube.com. FilterTube handles this by:
+YouTube Kids blocks cross-origin requests from https://www.youtube.com. FilterTube handles this by:
 
 1. **Using Kids watch pages** when possible
 2. **Falling back to main-world extraction** from Kids page HTML
 3. **Leveraging videoChannelMap** for previously resolved identities
 
 ### Fallback Strategy
 
-```
+```text
 Kids Native Block
 ├── Context Capture (videoId, channelId, channelName)
 ├── videoChannelMap Lookup (fast path)

html/tab-view.html

@@ -111,7 +111,7 @@
             </ul>
 
             <div class="sidebar-footer">
-                <div class="version-info">v3.1.6</div>
+                <div class="version-info">v3.1.7</div>
             </div>
         </nav>
 
@@ -268,7 +268,7 @@ <h3>Import / Export</h3>
                                                 Snapshot of channels, keywords, kids profiles, and themes.</br>
                                             </span>
                                             <span class="import-export-hint">
-                                                Saved as <code>filtertube_backup_YYYY-MM-DD.json</code>
+                                                Saved to <code>Downloads/FilterTube Export/</code>
                                             </span>
                                             <span class="info-hint" title="Download a portable JSON that includes every FilterTube list (channels, keywords, kids settings, design preferences, kids profiles, and more).">
                                                 Details
@@ -305,6 +305,26 @@ <h3>Import / Export</h3>
                         </div>
                     </div>
 
+                    <div class="card">
+                        <div class="card-header">
+                            <h3>Backups</h3>
+                        </div>
+                        <div class="card-body">
+                            <div class="toggle-row" title="When enabled, FilterTube will automatically save timestamped backups after you add/remove channels or keywords and after major settings changes.">
+                                <div class="toggle-info">
+                                    <div class="toggle-title">Enable Auto Backup</div>
+                                </div>
+                                <label class="switch">
+                                    <input id="setting_autoBackupEnabled" type="checkbox" data-ft-setting="autoBackupEnabled" />
+                                    <span class="slider round"></span>
+                                </label>
+                            </div>
+                            <div class="import-export-hint" style="margin-top:10px;">
+                                Auto backups are saved to <code>Downloads/FilterTube Backup/</code>.
+                            </div>
+                        </div>
+                    </div>
+
                 </div>
 
                 <div id="whatsnewView" class="view-section">
@@ -493,7 +513,7 @@ <h3>Import &amp; Export backups</h3>
                                     <div class="help-item-body">
                                         <ul>
                                             <li>Click <strong>Download JSON</strong> to capture the latest channels, keywords, Kids settings, and theme choices.</li>
-                                            <li>File name follows <code>filtertube_backup_YYYY-MM-DD.json</code> so you can keep multiple snapshots.</li>
+                                            <li>Export is saved to <code>Downloads/FilterTube Export/</code> (file name follows <code>filtertube_export_v3_YYYY-MM-DD.json</code>).</li>
                                             <li>Store it anywhere private (cloud drive, USB) for quick restores.</li>
                                         </ul>
                                     </div>
@@ -512,6 +532,40 @@ <h3>Import &amp; Export backups</h3>
                         </div>
                     </div>
 
+                    <div class="card">
+                        <div class="card-header">
+                            <h3>YouTube Kids Integration</h3>
+                        </div>
+                        <div class="card-body">
+                            <div class="help-list">
+                                <div class="help-item">
+                                    <div class="help-item-title">Passive Listening on YouTube Kids</div>
+                                    <div class="help-item-body">FilterTube provides complete Channel & Keyword based blocking on YouTube Kids by passively listening to the 3-dot menu UI in YT Kids content cards ("Block this video" and "Block this channel").</div>
+                                </div>
+                                <div class="help-item">
+                                    <div class="help-item-title">YouTube's Native Blocking vs FilterTube</div>
+                                    <div class="help-item-body">When parents block channels using YouTube Kids' native 3-dot menu, those blocks are managed by YouTube's system. FilterTube maintains its own separate blocklist for Kids Mode, giving you additional control and backup options.</div>
+                                </div>
+                                <div class="help-item">
+                                    <div class="help-item-title">Understanding Channel Blocking Behavior</div>
+                                    <div class="help-item-body">
+                                        <p>Parents should understand YouTube's complex channel blocking system:</p>
+                                        <ul style="margin: 8px 0; padding-left: 20px;">
+                                            <li>Channels blocked via YouTube Kids' native UI are managed by YouTube's system</li>
+                                            <li>FilterTube's passive listener creates entries in its own Kids Mode blocklist</li>
+                                            <li>If a channel doesn't appear after removing from FilterTube's list, it may still be blocked by YouTube's native system</li>
+                                            <li>Use YouTube's official unblocking process for native blocks: <a href="https://support.google.com/youtubekids/answer/7178746?hl=en#zippy=%2Cunblock-individual-channels-from-youtube-using-your-linked-parent-account" target="_blank" rel="noopener noreferrer">Unblock channels from YouTube using your linked parent account</a></li>
+                                        </ul>
+                                    </div>
+                                </div>
+                                <div class="help-item">
+                                    <div class="help-item-title">Parent Account Integration</div>
+                                    <div class="help-item-body">YouTube Kids blocking requires a verified parent account. Parents can block content from their child's YouTube Kids profile and share content from YouTube to their child's profile. See <a href="https://support.google.com/youtubekids/answer/7178746?hl=en" target="_blank" rel="noopener noreferrer">YouTube Kids Help Center</a> for complete details.</div>
+                                </div>
+                            </div>
+                        </div>
+                    </div>
+
                     <div class="card">
                         <div class="card-header">
                             <h3>Troubleshooting</h3>
@@ -520,7 +574,7 @@ <h3>Troubleshooting</h3>
                             <div class="help-list">
                                 <div class="help-item">
                                     <div class="help-item-title">"Failed to fetch" while blocking</div>
-                                    <div class="help-item-body">If FilterTube already knows the channel UC ID, it can still persist the block even if fetching the logo/name fails. Try reloading if the UI doesn’t update immediately.</div>
+                                    <div class="help-item-body">If FilterTube already knows the channel UC ID, it can still persist the block even if fetching the logo/name fails. Try reloading if the UI doesn't update immediately.</div>
                                 </div>
                                 <div class="help-item">
                                     <div class="help-item-title">Blocked channel still appears</div>