A Chrome extension that hides YouTube distractions — shorts, recommendations, comments, end screens, merch shelves, the lot.
Install on the Chrome Web Store →
Features · How it works · Running locally · Privacy
Open YouTube and Refine wipes the noise before the page paints. Per-element control over what gets hidden, a per-site pause toggle, dark/light themes, and a network-layer redirect that bounces you off /feed/trending before it loads. No accounts, no telemetry, no third-party requests.
Hide on the home page
- Home feed (with optional redirect to Subscriptions)
- Shorts (shelf, tab, reel grid, sidebar entry, the
/shorts/player surface) - Mixes
- Trending & Explore
- Subscriptions feed
Hide on the watch page
- Video sidebar (recommended, live chat, playlist as sub-toggles)
- End-screen feed and end-screen cards
- Fundraiser shelves
- Merch, tickets, offers
- Video info (with buttons-bar, channel, description as sub-toggles)
- Disable autoplay (via the player's own API)
- Disable annotations
Hide on the YouTube shell
- Comments (with profile-photos sub-toggle)
- Notifications
- Search suggestions
- Off-topic search shelves
- "More from YouTube" section
- Top header
Popup UX
- One switch per element, grouped into four sections
- Group-level switch in each section header — one tap hides everything in Watch page, or Comments, or whatever
- Indeterminate switch state when a group is partially on
- Status dot beside the domain — green = active, gray = paused on this site
- Live "elements hidden" meter
- Keyboard shortcut to pause Refine on the current site
- Theme picker (system / dark / light)
Settings live in chrome.storage.local. The content script runs at document_start and mirrors them as data-refine-* attributes on <html> before YouTube paints. A single static stylesheet uses those attributes as gates:
html[data-refine-on="1"][data-refine-shorts="hide"]
ytd-rich-shelf-renderer[is-shorts] { display: none !important; }A per-origin localStorage cache makes the first paint synchronous — no flash on repeat visits. SPA navigation, the network-layer redirects, and the autoplay disable are handled by a service worker and a page-world script. No DOM polling, no per-frame work.
Requires Bun.
git clone https://github.com/PaoloJN/refine.git
cd refine
bun install
bun run devThen in Chrome: chrome://extensions → enable Developer mode → Load unpacked → pick build/chrome-mv3-dev/.
To run the marketing site:
cd www
bun install
bun run dev # http://localhost:3000bun run dev # plasmo dev — hot-reloading extension build
bun run build # production build to build/chrome-mv3-prod/
bun run package # build + zip for Chrome Web Store upload- Import the repo at https://vercel.com/new
- In Project Settings → General, set Root Directory to
www - Framework auto-detects as Next.js; build/install commands stay at defaults
- Deploy
After the first deploy, update the SITE constant in www/src/app/sitemap.ts and the sitemap URL in www/src/app/robots.ts if your real domain differs from the placeholder.
. # Plasmo Chrome extension (root)
├── src/
│ ├── popup.tsx # action popup entry
│ ├── popup.css # design tokens + popup styles
│ ├── background.ts # service worker — DNR redirects, hotkey
│ ├── contents/
│ │ ├── youtube.ts # document_start — attrs + stylesheet + logo rewrite
│ │ └── youtube-page-world.ts # page-world — calls player.setAutonavState
│ ├── components/ # popup UI primitives
│ └── lib/ # model, settings, theme, css generator
├── assets/ # icon.png (Plasmo derives all sizes), logo.svg
├── www/ # Next.js 16 marketing site (App Router)
├── PRIVACY.md
└── LICENSE
The hiding pattern (data attributes on <html> + a single attribute-gated stylesheet) is a well-trodden approach popularised by Unhook. The selectors and code here are independently written. The popup UI was designed in Claude Design and built on Plasmo.
MIT — see LICENSE.