v1.12.0 · Chrome Extension

Block
Shorts.
Own Your Feed.

Block Shorts channels with one tap, hide the Shorts shelf entirely, and download full-quality videos via yt-dlp — all local, all private, zero telemetry.

View on GitHub See how it works →

Channels blocked

Languages

yt-dlp

Download engine

youtube.com/shorts/...

Features

Everything you need
to reclaim YouTube.

Three powerful tools in one lightweight extension. No account, no data collection, no cloud.

Channel blocking buttons

Injects an interactive Block button into every Shorts action bar. Send YouTube's native "Do not recommend" signal with one click — manual, safe, and transparent.

Premium Compliance

A hardened, multi-layered detection system using 5 independent signals disables all ad-blocking for YouTube Premium subscribers — across page loads, SPA navigations, and popup interactions. No TOS violations, no account bans.

4K Quality Lock

Force every video to play at the highest available resolution (2160p, 1440p) automatically. The extension locks your preference via native player APIs.

Hide Shorts shelves

Surgically removes the Shorts shelf from your homepage. Toggle it on or off instantly from the extension popup for a truly focused experience.

Native Downloader

Download full-quality 4K/1080p videos or pure MP3s directly to your machine using the powerful yt-dlp engine and our local companion bridge.

Global i18n support

Available in 11 languages including English, Türkçe, Deutsch, and more. Auto-detects your browser locale for a native, zero-setup experience.

How it works

Real UI.
Real code.

Every element below is rendered from the actual extension source — the exact same HTML and CSS that runs in Chrome.

          popup.html · page-settings

chrome-extension://…/popup.html

Settings

Shorts Blocking

Enable channel blocking buttons

Adds interactive Block buttons to the Shorts feed

Block channels automatically

Adds channel to blocklist on click

Hide Shorts from homepage

Removes Shorts shelf from feed

Ad Blocker

Block video ads

Auto-skip & hide ads

This feature bypasses YouTube's ad system and may violate its Terms of Service. Use at your own risk.

Quality Lock

Force highest quality

Always play at max resolution

Uses non-public player APIs. May be identified as unusual behavior. Use at your own risk.

Downloader

Show download button

In video player controls

Language

Interface Language

Override browser default

Block button injection

A MutationObserver watches for new Shorts to load in the DOM. When found, the extension injects a Block button directly into the native action bar — seamlessly styled to match YouTube's design language.

YouTube's own signal

Clicking Block triggers YouTube's native "Don't recommend channel" flow programmatically — the same action as using their own menu. The channel handle is then stored in chrome.storage.local.

CSS-injected feed hiding

The homepage toggle adds a class to body that CSS selectors pick up. The Shorts shelf disappears instantly — no reload, no flicker. Toggle off equally fast.

Privacy-Focused Ad Blocking

A hybrid engine uses CSS hiding for instant layout stabilization and a MutationObserver on #movie_player that reacts in under 1ms when an ad starts — replacing the old 700ms polling loop. A 250ms fallback interval handles edge cases. All ad logic is fully disabled for Premium subscribers before it ever runs.

Native messaging bridge

Download requests pass from the content script → background service worker → native Node.js host via chrome.runtime.connectNative. yt-dlp then handles 4K acquisition on your device.

i18n in 11 languages

A lightweight i18n engine reads the browser locale (or your manual override) and applies translations to every data-i18n attribute in the DOM — including dynamic strings from JS — before rendering.

Live UI Previews

See it in action.

Every component below is rendered from the actual extension source — the same HTML and CSS that runs inside Chrome.

style.css · shorts action bar injection

Shorts · reel-action-bar-view-model

                NATIVE YT BUTTONS

18K

243

                    ↑ INJECTED

Block

● Click the Block button — it toggles between normal and blocked states, just like the real extension.

style.css · .yt-dl-modal

● yt-dlp fetches available streams and presents quality options. This modal appears directly over the YouTube video player.

setup.html · native host setup wizard

YouTube Shorts Blocker

Native Downloader Setup

Connect Chrome to yt-dlp running on your machine for high-quality downloads.

Connected successfully!

Open the native-host folder inside this extension.

Double-click install_host.bat to run the installer.

Enter your Extension ID when prompted:

abcdefghijklmnopqrstuvwxyzabc

● The setup wizard guides you through connecting Chrome to yt-dlp via Native Messaging — all running locally on your machine.

Privacy

Zero telemetry.
Your data stays yours.

Designed from the ground up with privacy as a first principle — not an afterthought.

No data collected

Nothing you do on YouTube is sent anywhere. No analytics, no tracking pixels, no crash reports. Your watch history and block decisions are entirely your own.

Local storage only

All settings, stats, blocked channel handles, and language preferences live exclusively in chrome.storage.local. On your device. Under your control.

Open source · MIT

Every line of code is public and auditable on GitHub. No hidden requests, no obfuscation, no surprise. Fork it, inspect it, run it exactly as-is.

Installation

Up and running
in 60 seconds.

Not on the Chrome Web Store — installed directly via Developer Mode. Takes less than a minute. The yt-dlp downloader is optional.

Extension

Clone or download the repo as a ZIP from GitHub

Open Chrome and go to chrome://extensions/

Enable Developer mode (top-right toggle)

Click Load unpacked and select the extracted folder

Visit youtube.com, refresh, and enjoy

Optional — Native Downloader:
Install Node.js, then run install_host.bat from the native-host folder. The Setup page in the extension popup walks you through it step by step.

Free & Open Source

MIT Licensed · No account required

View on GitHub

Part of Paracci Browser Tools

Block Shorts. Own Your Feed.

Everything you needto reclaim YouTube.