Manifest V3 · Browser Extension

Chroma
Ad‑Blocker

Multi-layered protection built for the modern web. Accelerate, block, and filter ads — all locally on your device, zero data collected.
Always free, open-source, and compatible with Windows, Mac, and Linux.

Protection Layers

Built to Outlast
Every Ad System

Six independent layers of protection, each targeting a different attack vector. Together they handle anything ad networks throw at your browser.

Ad Acceleration

Automatically identifies and accelerates video ads at a configurable speed (×4–×16, default ×8) with audio muted, delivering a seamless experience without intrusive interruptions.

YouTube & Prime Video

Network Blocking

A multi-part Declarative Net Request (DNR) system blocks tracker pings, analytics beacons, and traditional banner ads at the browser level before they load.

Multi-part DNR ruleset

Global Components

Hide non-video components like Shorts, merchandise carousels, and rental offers, while removing unsolicited overlay dialogs that restrict content access based on browser configuration.

Shorts · Merch · Offers

Cosmetic Filtering

MutationObserver-driven CSS injection surgically removes ad placeholders, empty slots, and layout artifacts in real time as pages load and navigate.

MutationObserver

Filter Subscriptions

Automatically syncs Hagezi Pro Mini and Chroma Hotfix filter lists every 24 hours, keeping network blocking rules current without any user intervention.

Hagezi Pro Mini · Chroma Hotfix

Hardened Security

A session-based token handshake ensures secure communication between execution worlds, while local-only processing keeps your data private.

Secure Handshake · Local-Only

Architecture

How Chroma Works

Chroma uses a privacy-first, multi-layered security engine to identify and neutralize ads before they reach your screen. By processing everything locally on your device, your data stays 100% private while you enjoy a cleaner, faster web.

graph TD classDef actor fill:#1a1040,color:#ede8ff,stroke:#8b949e,stroke-width:2px classDef engine fill:#1a1040,color:#ede8ff,stroke:#01579b,stroke-width:2px classDef action fill:#1a0a35,color:#ede8ff,stroke:#f57f17,stroke-width:2px classDef support fill:#1a0a35,color:#ede8ff,stroke:#6c5ce7,stroke-width:2px classDef title fill:none,stroke:none,color:#ede8ff,font-size:16px,font-weight:bold INTERNET["The Internet (Ads & Content)"]:::actor subgraph CHROMA[" "] TITLE["Chroma Ad-Blocker Engine"]:::title NETWORK["Network Shield (Blocks Trackers & Banners)"]:::action LISTS["Live Filter Lists (Refreshed Every 24 Hours)"]:::support VIDEO["Video Accelerator (Speeds Through Video Ads)"]:::action CONTENT["Content Cleaner (Removes Overlays & Placeholders)"]:::action SCRIPTLETS["Script Neutralizer (Disables Anti-Adblock Scripts)"]:::action TITLE --> NETWORK TITLE --> VIDEO TITLE --> CONTENT TITLE --> SCRIPTLETS LISTS -.->|"supplements"| NETWORK end USER["The User (Cleaned Experience)"]:::actor INTERNET --> TITLE NETWORK --> USER VIDEO --> USER CONTENT --> USER SCRIPTLETS --> USER style CHROMA fill:none,stroke:none

Quick Start

Up and Running
in Under a Minute

1

Click Download Current Version or get the latest release from GitHub, and extract the ZIP file.

2

Open chrome://extensions in Chrome.

3

Toggle on Developer Mode in the top-right corner.

4

Click Load unpacked and select the extension/ folder inside the extracted directory.

5

Done — Chroma is active on all tabs. Pin it from the extensions menu to access the popup.

Support the Project

Chroma is 100% free, source-available, and always will be. It is built and maintained by a single developer. If it has improved your web experience, consider supporting the work with a coffee.

Buy me a coffee