Skip to content
@ProtoConsent

ProtoConsent

User-side, purpose-based consent for the web. Open-source browser extension + blocklists.

ProtoConsent

ProtoConsent logo

Consent you can express, enforce and observe

User-side, purpose-based consent for the web

Browser extension · Blocklists · Website

ProtoConsent organizes privacy around purposes instead of individual trackers or domains. The project has two main outputs: a browser extension for end users and purpose-based blocklists for any tool.

No central server, no tracking, no sharing of personal data.


Browser extension

version 0.7.2 GPL-3.0+ Manifest V3 Chromium Firefox in review

A personal consent control panel that lives in the browser. Purpose-based blocking, tracker detection, and signal management in one place - can coexist with existing blockers and consent tools.

  • Per-site profiles and purpose toggles: choose a default privacy profile that applies everywhere, then override per site and refine individual purposes across six data-use categories.
  • Enhanced protection out of the box: curated blocklists, cosmetic filtering, CNAME detection, URL parameter stripping, and regional filters for 36 languages - enabled by default and kept up to date automatically.
  • Two operating modes: Blocking enforces purpose-based blocking directly. Monitoring delegates to your existing blocker and adds purpose attribution and signal observability.
  • Consent banner handling: cosmetic hiding, scroll unlock, and experimental cookie injection to auto-respond to consent banners based on your purpose preferences. No DOM interaction, no click simulation.
  • Site declarations: websites can publish .well-known/protoconsent.json to declare their data practices. Open protocol with spec, JSON Schema (source), validator, and GitHub Action.
  • JavaScript SDK (MIT) for web pages to query user preferences via protoconsent.get('analytics').

ProtoConsent popup    Overview tab dashboard

Available in the Chrome Web Store   Get it from Microsoft Edge

Brave Brave via Chrome Web Store    Firefox Mozilla Firefox - in review    Opera Opera Addons - in review

Also works on Vivaldi, Arc, and any Chromium-based browser.


Purpose-based blocklists

250K+ domains 6 purposes 5 formats Updated daily

Tracker blocklists organized by data-processing purpose, available in 5 formats. Use them with any ad blocker, DNS sinkhole, or browser extension - no ProtoConsent extension required.

Format Compatible with
ABP uBlock Origin, Adblock Plus, Ghostery
AdGuard AdGuard browser extension
Hosts Pi-hole, AdGuard Home, /etc/hosts
Domains NextDNS, ControlD, RethinkDNS
JSON MV3 browser extensions, custom tools

Six purpose lists: Ads, Analytics, Personalization, Third Parties, Advanced Tracking, Security.

See the data repo for download links and quick start URLs.


Repositories

Repo Description
ProtoConsent Browser extension, SDK, protocol spec, and documentation
data Purpose-based tracker blocklists in 5 formats - 250K+ domains, updated daily
protoconsent.org Project website, blog, validator, generator, and directory
demo Demo site with live SDK test and .well-known declaration
validate-action GitHub Action + CLI to validate .well-known/protoconsent.json

Links

Website: protoconsent.org · Live demo: demo.protoconsent.org · Developer docs: protoconsent.org/developers

Pinned Loading

  1. ProtoConsent ProtoConsent Public

    Browser extension for purpose-based privacy control. Per-site profiles, 6 purpose toggles, CMP auto-response, GPC signaling, and JavaScript SDK.

    JavaScript 2

  2. data data Public

    Purpose-based tracker blocklists in 5 formats (ABP, AdGuard, hosts, domains, JSON). 250K+ domains organized by purpose: ads, analytics, personalization, tracking, security.

    JavaScript 10 2

  3. validate-action validate-action Public

    GitHub Action and CLI to validate .well-known/protoconsent.json site declarations against the ProtoConsent schema.

    JavaScript 1

  4. protoconsent.org protoconsent.org Public

    Official website for ProtoConsent - browser-level, purpose-based consent controls

    HTML 1

  5. demo demo Public

    Demo site for ProtoConsent with live SDK test, .well-known declaration, and GPC signal check. Hosted at demo.protoconsent.org.

    CSS 1

Repositories

Showing 6 of 6 repositories

Top languages

Loading…

Most used topics

Loading…