YouTube - Filter Subscriptions Page

hide videos with given keywords in title on YouTube home and subscriptions pages

Você precisará instalar uma extensão como Tampermonkey, Greasemonkey ou Violentmonkey para instalar este script.

Você precisará instalar uma extensão como Tampermonkey para instalar este script.

Você precisará instalar uma extensão como Tampermonkey ou Violentmonkey para instalar este script.

Você precisará instalar uma extensão como Tampermonkey ou Userscripts para instalar este script.

Você precisará instalar uma extensão como o Tampermonkey para instalar este script.

Você precisará instalar um gerenciador de scripts de usuário para instalar este script.

(Eu já tenho um gerenciador de scripts de usuário, me deixe instalá-lo!)

Você precisará instalar uma extensão como o Stylus para instalar este estilo.

Você precisará instalar uma extensão como o Stylus para instalar este estilo.

Você precisará instalar uma extensão como o Stylus para instalar este estilo.

Você precisará instalar um gerenciador de estilos de usuário para instalar este estilo.

Você precisará instalar um gerenciador de estilos de usuário para instalar este estilo.

Você precisará instalar um gerenciador de estilos de usuário para instalar este estilo.

(Eu já possuo um gerenciador de estilos de usuário, me deixar fazer a instalação!)

// ==UserScript==
// @name         YouTube - Filter Subscriptions Page
// @namespace    https://zachhardesty.com
// @author       Zach Hardesty <[email protected]> (https://github.com/zachhardesty7)
// @description  hide videos with given keywords in title on YouTube home and subscriptions pages
// @copyright    2019-2026, Zach Hardesty (https://zachhardesty.com/)
// @license      GPL-3.0-only; http://www.gnu.org/licenses/gpl-3.0.txt
// @version      2.2.2

// @grant        GM_getValue
// @grant        GM_setValue
// @grant        GM_registerMenuCommand

// @homepageURL  https://github.com/zachhardesty7/tamper-monkey-scripts-collection/raw/master/youtube-filter-subscriptions-page.user.js
// @homepage     https://github.com/zachhardesty7/tamper-monkey-scripts-collection/raw/master/youtube-filter-subscriptions-page.user.js
// @homepageURL  https://openuserjs.org/scripts/zachhardesty7/YouTube_-_Filter_Subscriptions_Page
// @homepage     https://openuserjs.org/scripts/zachhardesty7/YouTube_-_Filter_Subscriptions_Page
// @supportURL   https://github.com/zachhardesty7/tamper-monkey-scripts-collection/issues


// @match        https://www.youtube.com/*
// @require      https://update.greatest.deepsurf.us/scripts/419640/1776135/onElementReady.js
// ==/UserScript==

/* global onElementReady */

const HIDDEN_CLASSNAME = "zh-hidden"
const GM_FILTERS_KEY = "yt-filter-page"

/** for `youtube.com` home page */
const SELECTOR_HOME_PAGE = 'ytd-browse[page-subtype="home"]'
/** for `youtube.com/feed/subscriptions` page */
const SELECTOR_SUBS_PAGE = 'ytd-browse[page-subtype="subscriptions"]'

/** for grid view */
const SELECTOR_GRID_ITEM = "ytd-rich-item-renderer.ytd-rich-grid-renderer"
const SELECTOR_GRID_ITEM_TITLE = "a.ytLockupMetadataViewModelTitle"

/**
 * for list view
 *
 * @todo - incorrectly selects shorts
 *
 * @todo - don't think it's possible to view as list anymore
 */
const SELECTOR_LIST_ITEM = `ytd-item-section-renderer.ytd-section-list-renderer`
const SELECTOR_LIST_ITEM_TITLE = `#video-title yt-formatted-string`

let keywords = GM_getValue(GM_FILTERS_KEY, "")

const stylesheet = document.createElement("style")
const head = document.head || document.querySelectorAll("head")[0]
stylesheet.id = "hiding" // to edit later
stylesheet.type = "text/css"
stylesheet.append(
  document.createTextNode(`
  .zh-hidden {
    display: none !important;
  }
`),
)
head.append(stylesheet)

onElementReady(
  `:is(${SELECTOR_HOME_PAGE}, ${SELECTOR_SUBS_PAGE}) :is(${SELECTOR_GRID_ITEM}, ${SELECTOR_LIST_ITEM})`,
  { findOnce: false },
  (el) => {
    const videoTitle = el
      ?.querySelector(`:is(${SELECTOR_GRID_ITEM_TITLE}, ${SELECTOR_LIST_ITEM_TITLE})`)
      ?.textContent.toLowerCase()

    for (const keyword of keywords.toLowerCase().split(",")) {
      if (keyword && videoTitle?.includes(keyword)) {
        el.classList.add(HIDDEN_CLASSNAME)
        return
      }
    }

    el.classList.remove(HIDDEN_CLASSNAME)
  },
)

GM_registerMenuCommand("Set YT Filter Subscriptions Page Keywords", () => {
  // eslint-disable-next-line no-alert
  const val = prompt(
    "input a comma separated list of keywords (case insensitive)",
    keywords,
  )

  if (val !== null) {
    keywords = val
    GM_setValue(GM_FILTERS_KEY, val)
  }
})