YouTube Mix Blocker

A small browser extension that removes YouTube Mix recommendations from YouTube pages and cleans Mix watch URLs so videos open as regular video links.

Features

• Blocks YouTube Mix cards in recommendations.
• Blocks YouTube Mix cards in search results.
• Blocks YouTube Mix cards in watch-page sidebar recommendations.
• Removes empty home-grid spaces left behind after Mix cards are blocked.
• Cleans Mix watch URLs by removing Mix playlist parameters.
• Includes an optional popup with counters for blocked Mixes and cleaned URLs.
• Keeps the badge counter disabled by default.
• Supports 50 localized extension UI languages.

Install

Chrome Web Store

Install the published extension from the Chrome Web Store.

Firefox Add-ons

The Firefox build is prepared for submission to Mozilla Add-ons. Build and package it with:

npm run package:firefox

Upload the generated release/youtube-mix-blocker-firefox-1.5.1.zip package in the Firefox Add-ons Developer Hub.

From Source

1. Install dependencies:

   npm install

2. Build the Chrome extension:

   npm run build:chrome

3. Open chrome://extensions, enable Developer mode, choose Load unpacked, and select the generated dist/ directory.

Development

Source files live in src/. Build output is generated into dist/ for Chrome and dist-firefox/ for Firefox.

Useful commands:

npm run build:chrome
npm run build:firefox
npm run build:all
npm run lint:firefox
npm run package:firefox
npm run check

npm run check builds both targets and runs syntax checks on the generated JavaScript files. npm run lint:firefox validates the Firefox build with Mozilla's web-ext linter.

The browser-specific manifest is generated during the build:

• Chrome uses a Manifest V3 service worker background.
• Firefox uses the shared background script as a Manifest V3 background script.

Project Structure

• src/ - extension source files.
• src/content/ - YouTube page detection, blocking, URL cleanup, and SPA event handling.
• src/popup/ - extension popup UI.
• src/_locales/ - extension localization messages.
• dist/ - generated Chrome build.
• dist-firefox/ - generated Firefox build.
• EXTENSION_SPEC.md - browser-specific behavior notes and release rules.
• store-listing/ - Chrome Web Store and Firefox Add-ons listing text, screenshots, promo images, and review notes.
• release/ - locally generated upload packages.

Privacy

YouTube Mix Blocker does not collect, transmit, sell, or share personal data or browsing data. Settings and counters are stored locally in the browser and are used only to provide the extension's features.

See PRIVACY.md for the full privacy policy.

Release Notes

See CHANGELOG.md.

Feedback

Feedback is welcome. You can leave a review on the Chrome Web Store, open an issue on GitHub, or write to molodchykr@gmail.com.

Support

If this extension saves you time and you want to support its development:

License

Licensed under GPL-3.0-or-later. See LICENSE.txt.