blockmaxxing

Watch Twitch without the ads — a local-first extension that removes stream-level ads directly in your browser.

Chrome · Firefox Manifest V3 TypeScript No backend No telemetry MIT
blockmaxxing — block Twitch ads, privately

What it does

🛡️ Stream-level blocking

Intercepts the HLS playlist inside the player and swaps out ad segments — the technique that works against Twitch's server-side ad insertion.

🔒 Truly private

No backend, no analytics, no accounts. Everything runs on your device and talks only to Twitch's own APIs.

✅ Whitelist favorites

Support the streamers you love — whitelist any channel with one click to let their ads play.

🧩 Chrome & Firefox

One codebase, both browsers, both on Manifest V3. Reproducible builds you can inspect and package yourself.

📊 On-device diagnostics

Optional, opt-in event log stored only in your browser. Nothing ever leaves your machine.

🛠️ One-file to patch

Every Twitch-dependent value lives in a single config module, so keeping up with Twitch is a one-commit change.

Install in one click

Get it from your browser's store. Add to Chrome or Add to Firefox.
Watch ad-free. Open any Twitch channel. Click the toolbar icon for blocked-ad stats or to whitelist a channel.
Prefer to build it yourself? Clone the repo, run npm install then npm run extension:build, and load build/chromium or build/firefox/manifest.json unpacked.

How it works

LayerResponsibility
vendor engineHooks the player's HLS worker, detects stitched ad segments, and swaps to a clean backup stream. Vendored from the MIT-licensed TwitchAdSolutions project.
content.tsInjects the engine at document_start when enabled and the channel is not whitelisted, and counts real block events.
background.tsPersists settings and the blocked-ad counter, and syncs changes to open tabs.

Honest expectations

No Twitch ad blocker is perfect. Twitch stitches ads into the video stream and actively changes how it works, so any blocker — this one included — will occasionally let an ad through until it is updated. blockmaxxing blocks the large majority of ads and is designed to be easy to patch. It does not modify your account or act on your behalf beyond loading an ad-free stream.