YouTube Channel Filter

Filter YouTube videos by channel, keyword, duration, language, live streams and members-only content. Full blocklist/whitelist management with quick action buttons on video cards.

You will need to install an extension such as Tampermonkey, Greasemonkey or Violentmonkey to install this script.

You will need to install an extension such as Tampermonkey to install this script.

You will need to install an extension such as Tampermonkey or Violentmonkey to install this script.

You will need to install an extension such as Tampermonkey or Userscripts to install this script.

You will need to install an extension such as Tampermonkey to install this script.

You will need to install a user script manager extension to install this script.

(I already have a user script manager, let me install it!)

You will need to install an extension such as Stylus to install this style.

You will need to install an extension such as Stylus to install this style.

You will need to install an extension such as Stylus to install this style.

You will need to install a user style manager extension to install this style.

You will need to install a user style manager extension to install this style.

You will need to install a user style manager extension to install this style.

(I already have a user style manager, let me install it!)

Аўтар
MayoHu
Усталяванняў за дзень
1
Усяго ўсталяванняў
40
Рэйтынг
0 0 0
Версія
1.1.1-rc1
Створаны
29.08.2025
Абноўлены
27.04.2026
Памер
194.8 КБ
Ліцэнзія
MIT
Ужываецца на

YouTube 頻道過濾器 — 使用說明

v1.1.0 | Tampermonkey userscript | 繁中 & English


🔗 快速導覽


安裝

  1. 瀏覽器安裝 Tampermonkey 擴充功能(Chrome / Firefox / Edge 皆可)
  2. 開啟 userscript 檔案:youtube-channel-filter-v1.1.0.user.js
  3. Tampermonkey 自動提示安裝 → 確認即可
  4. 打開任何 YouTube 頁面,右下角應看到 🔍 浮動按鈕

驗證版本

開啟面板(點 🔍 或 Tampermonkey 選單「⚙️ 開啟管理面板」),面板右上角應顯示 v1.1.0 字樣。


語系切換

介面預設跟隨系統語言(繁中 / 英文)。切換方式:

  1. 點擊 🔍 開啟管理面板
  2. 到「⚙️ 設定」Tab
  3. 最頂部「⚙️ 全域設定」區塊 → 找「🌐 介面語言」下拉選單
  4. 選擇「繁體中文」或「English」→ 立即生效(面板與所有卡片按鈕皆會更新)

語言設定儲存在 ytf_lang,跨瀏覽器分頁同步。


🚫 隱藏名單 Blocklist

所有加入此清單的頻道,其所有影片將從列表頁(首頁、搜尋、推薦、訂閱等)完全隱藏

新增頻道

方法 A:從影片卡片快速加入

  1. 滑鼠 hover 任何影片卡片
  2. 卡片底部滑出「🚫 隱藏此頻道」按鈕 → 點擊
  3. 該頻道所有影片立即消失

方法 B:從面板手動加入

  1. 開啟面板 → 「🚫 隱藏名單」Tab
  2. 點「+ 新增」按鈕
  3. 填入頻道名稱或 @handle,可選擇勾選「⌥R.* Regex 模式」
  4. 點「確認」

管理條目

按鈕 說明
✏️ 編輯頻道名稱 / ID / Regex 模式 / 標籤
移除(雙次確認避免誤刪)
🏷 打開該條目的標籤管理面板
🗑 清空全部 清空整個隱藏名單(有確認對話框)

搜尋

上方的搜尋欄可即時搜尋頻道名稱或 @handle;標籤篩選列可按標籤過濾。


⭐ 白名單 Whitelist

所有加入此清單的頻道將永遠顯示(不受任何過濾規則影響)。

用途

  • 確保重要頻道不會被關鍵字或其他過濾條件誤殺
  • 配合「⭐ 只顯示白名單頻道」設定,打造僅限信任頻道的瀏覽模式(如兒童模式)
  • 已加入白名單的頻道不會顯示「🚫 隱藏」快捷按鈕(減少誤操作)

新增 / 管理

操作方式與隱藏名單相同(可從卡片快捷按鈕 ⭐ 或從面板手動加入)。

白名單條目也支援:

  • 標籤管理(🏷 按鈕)
  • 編輯(✏️ 按鈕)
  • 標籤篩選列(頂部 chip 列)
  • CSV 匯出含 tags 欄位

白名單與隱藏名單的標籤池完全獨立,即使同名也各算各的。


🔤 關鍵字 Keywords

可建立多個「關鍵字群組」,每個群組包含多個關鍵字,影片標題或描述命中任一關鍵字即會被隱藏。

建立群組

  1. 點「+ 新增群組」
  2. 填入群組名稱(如「政治」、「業配」、「危險內容」)
  3. 選擇套用範圍:「標題」、「描述」(至少勾選一個)
  4. 點「建立」

加入關鍵字

  1. 在群組內點「+ 關鍵字」
  2. 輸入關鍵字或 Regex 模式
  3. 勾選「Regex」checkbox 則啟用正規表達式模式
  4. 點「加入」

管理群組

按鈕 說明
🔴 / ⚪ 啟用 / 停用該群組(不刪資料)
↑ ↓ 調整群組優先順序
✏️ 編輯群組名稱 / 套用範圍
🗑 刪除群組 刪除整個群組(有確認)

搜尋群組 / 關鍵字

群組列表上方的搜尋框可即時過濾:

  • 輸入「業配」→ 只顯示群組名或關鍵字含「業配」的群組
  • 命中的關鍵字 chip 會以金色螢光高亮,群組名命中則金色文字

⚙️ 設定 Settings(過濾條件)

設定頁分成多個區塊,由上至下:

💾 儲存設定(置頂)

按下此按鈕才會儲存你做的所有設定變更。

⚙️ 全域設定

  • 🌐 介面語言:繁體中文 / English
  • 顯示操作通知 (Toast):關閉後 toast 不出現,但 log 仍記錄
  • 顯示統計 & 歷史 Tab:關閉後 UI 不顯示這兩個 Tab,資料仍追蹤

⭐ 白名單獨享模式

開啟後只顯示白名單頻道,其他所有頻道被隱藏。這是兒童保護設定的核心開關。

⏱ 影片時長

  • 最短 / 最長時長(秒)
  • 範例:60 / 600 → 只顯示 1 到 10 分鐘的影片

📡 直播 / 首播

  • 隱藏直播中影片
  • 隱藏即將首播影片

👑 會員專屬

隱藏所有會員才能看的影片

📅 上傳日期

  • 支援語義範圍:「N 天內」、「N 週內」、「N 個月內」、「N 年內」
  • 預設「30 天內」

👁 觀看數

  • 最低 / 最高觀看數
  • 直接輸入數字(10000)或用 K/M 縮寫(10K = 10,000, 1M = 1,000,000)
  • 直播觀看人數不計入

🌐 語言過濾

  • 模式:阻擋特定語言 / 僅允許特定語言
  • 常用語言勾選:日文 / 韓文 / 中文 / 英文 / 俄文 / 阿拉伯文 / 西班牙文 / 法文 / 德文 / 葡萄牙文 / 印地文 / 泰文 / 越南文 / 印尼文 / 土耳其文 / 義大利文
  • 自訂代碼:逗號分隔的 BCP-47 代碼(如 nl, pl, sv
  • 偵測原理:標題字元集分析。拉丁語系(越南文、法文等)因字元重疊偵測準確度較低,建議搭配關鍵字過濾

📊 統計 Stats & 📋 歷史 History

📊 統計

  • 關鍵字排行:哪個關鍵字最常觸發隱藏
  • 頻道排行:哪個頻道最常被隱藏(顯示名稱便於辨識)
  • 兩欄並排顯示,一目了然

📋 歷史

  • 最近 500 筆被隱藏的影片記錄
  • 包含:影片標題、頻道名稱、頻道 ID、觸發原因、隱藏時間
  • 支援搜尋與匯出 CSV

💾 匯出入 Import / Export

匯出全部設定(JSON)

打包所有隱藏名單、白名單、關鍵字、過濾設定為 JSON 檔案。

分別匯出(CSV)

  • 隱藏名單 CSV(含標籤欄)
  • 白名單 CSV(含標籤欄)
  • 關鍵字 CSV(含群組名、範圍、Regex 標記)
  • 統計資料 JSON
  • 歷史記錄 CSV(觸發原因會本地化為描述文字)

所有 CSV 都包含 UTF-8 BOM,Windows Excel 可直接開啟不亂碼。

匯入設定

  1. 選擇匯入模式:覆蓋 / 合併
  2. 選擇檔案:JSON(完整備份)或 CSV(單項)

自動備份

  • 開啟「自動備份」→ 每 N 小時自動下載一次備份 JSON
  • 可自訂檔名前綴(預設 yt-filter-backup-

分享清單

一鍵產生包含選定清單(隱藏 / 白名單 / 關鍵字 / 全部)的 URL 連結,他人點擊即可在他們的腳本中一鍵匯入。不傳送到任何伺服器(資料編碼在 URL 本身)。


🏷️ 標籤系統

為什麼用標籤?

當隱藏名單或白名單有幾百個頻道時,用標籤分組方便管理:

  • 「政治」「業配」「搬運」分類
  • 「可信」「待觀察」「兒童適用」等自訂分類
  • 離線處理匯出的 CSV 時可用 Tags 欄分類整理

新增標籤

方法 A:透過 🏷 快速面板

  1. hover 頻道條目 → 點 🏷
  2. 面板展開,分兩區塊:
    • 📝 新增標籤 — 輸入新標籤 + 按 Enter 或點 +
    • 📌 所有標籤(✓已擁有、點擊切換) — 系統所有標籤的 chip 列,點擊即切換狀態

方法 B:編輯表單

點 ✏️ 打開編輯表單,「tags」欄位支援逗號分隔輸入,同時下方有「📌 所有標籤」chip 列可點擊切換。

篩選

每個清單頂部有 標籤篩選列

  • 全部 (200) → 顯示所有條目
  • 政治 (15) → 只顯示含「政治」標籤的條目

重要規則

項目 說明
標籤獨立性 隱藏名單標籤 vs 白名單標籤各自獨立,即使同名也分別計算
即時同步 新增 / 移除標籤後所有相關 UI 立即刷新
空篩選自動重置 若篩選的標籤被完全移除,清單自動回到「全部」

🔍 Regex 模式完整指南

何時使用 Regex

在「頻道隱藏 / 白名單」條目或「關鍵字群組」內勾選 ⌥R.* Regex 模式 後啟用。適合:

  • 比對特定字首 / 字尾
  • 批次命名規則(EP1 / EP.1 / EP 1 等)
  • 避免部分匹配(如只要「NASA」不要「NASA-related」)

預設不分大小寫

常用語法

語法 說明
^abc 以 abc 開頭
abc$ 以 abc 結尾
`a\ b`
\d+ 一個或多個數字
\b 單詞邊界(避免部分匹配)
.* 任意字元(零或多個)
[0-9] 字元範圍

實用範例

Pattern 比對
^\[業配\] 所有標題以「[業配]」開頭的影片
\bNASA\b 獨立出現 NASA(避開「NASA-related」)
`(股票\ 投資\
EP\.?\d+ 匹配 EP1 / EP.1 / EP 1 等集數格式
^(?!.*官方).*$ 標題包含「官方」的所有影片(負向先行斷言)

提示

不需要加 //i 標記,直接輸入 pattern 即可。反斜線跳脫由 UI 自動處理。


🛡️ 兒童保護設定範例

利用腳本現有功能,打造「白名單專享 + 危險內容自動過濾」的兒童友善瀏覽環境:

6 步驟

第 1 步白名單:到 ⭐ 白名單 Tab 加入孩子可看的頻道(例如 @PBSKids@SesameStreet@CocomelonOfficial

第 2 步白名單獨享:到 ⚙️ 設定 最頂部,勾選「⭐ 只顯示白名單頻道」 — 其他所有頻道都會被隱藏

第 3 步禁直播:勾選「📡 直播 / 首播」區塊內的「隱藏直播中」和「隱藏即將首播」 — 避免直播聊天室風險

第 4 步關鍵字黑名單:到 🔤 關鍵字 建立「危險內容」群組,加入如「暴力、血腥、恐怖、成人、賭博」等字詞並啟用(可用 Regex:(暴力|血腥|恐怖|成人)

第 5 步(可選)限制日期:到 📅 上傳日期 設定「隱藏 30 天前上傳的影片」 — 避免演算法推送陳年爭議內容

第 6 步(可選)語言過濾:到 🌐 語言過濾 選擇「僅顯示指定語言」並只勾選孩子的母語

⚠️ 重要警語

此腳本僅過濾首頁 / 搜尋 / 推薦等列表頁,無法阻止

  • 直接輸入影片 URL
  • 偵測影片實際內容(只看 metadata)

強烈建議搭配

  • YouTube Kids 應用程式
  • 家長監護軟體(Google Family Link 等)
  • 路由器層級的 DNS 過濾(如 CleanBrowsing、NextDNS)

⌨️ 快捷操作

操作 行為
頂欄 🔍 按鈕 左鍵 開啟管理面板
頂欄 🔍 按鈕 右鍵 切換過濾器開關(臨時看原始 YouTube)
影片卡片 hover 底部滑出「🚫 隱藏」「⭐ 白名單」按鈕
Tampermonkey 選單 提供「開啟面板」「切換過濾器」「立即備份設定」選項

Debug 模式

透過 Tampermonkey 選單「🔍 切換 Debug 模式」開啟後:

  • 瀏覽器 console 會輸出詳細運作日誌
  • 可執行 __ytfReport() 查看統計
  • 正常使用時保持關閉以避免雜訊

常見問題

Q: Tampermonkey 沒偵測到新版本更新?

刪除舊版本 → 重新安裝新版本。安裝後透過面板右上角版本徽章確認載入的版本。

Q: 匯出的 CSV 在 Excel 中中文亂碼?

確認版本為 v1.1.0 以上(已加入 UTF-8 BOM 修正)。若仍亂碼,嘗試 Excel「資料」→「從文字檔」選 UTF-8 編碼匯入。

Q: 語言偵測不準?

拉丁語系語言(英文、西班牙文、越南文、法文等)因字元重疊偵測準確度較低,建議搭配關鍵字過濾做更精準的過濾。

Q: 白名單加了還是被隱藏?

可能原因:

  1. 頻道 ID 或名稱拼寫不一致(包含大小寫)
  2. 頻道是合輯 / YouTube Mix(非單一頻道內容)
  3. 如果是 Regex 模式,check pattern 是否正確比對

Q: 為什麼有些影片標籤無法被關鍵字過濾?

關鍵字只比對可見的標題與描述。若影片的描述被 YouTube 折疊或縮短,描述比對可能失效。建議同時加入「標題」範圍。

Q: 資料存在哪?

  • ytf_bl / ytf_wl / ytf_kg / ytf_fl / ytf_gl:各類清單設定
  • ytf_st / ytf_hi:統計與歷史
  • ytf_vcm:videoId→channelId 快取
  • ytf_lang:介面語言

所有資料儲存在 Tampermonkey 的 GM Storage 中,不上傳任何伺服器。


連結