A high-performance, local-first browser extension designed to block advertisements, telemetry tracking, popups, cryptominers, and malicious phishing domains. Natively built on Manifest V3 using Google Chrome's declarativeNetRequest engine for zero memory bloat and C++ execution speed.
ad-blocker/
├── _metadata/ # Chrome extension metadata
├── rules/ # Declarative Net Request ruleset JSON files
│ ├── ads.json # Display and video ad blocking rules
│ ├── trackers.json # Analytics and telemetry blocking rules
│ ├── annoyances.json # Cookie consents and anti-adblock bypasses
│ └── malware.json # Phishing, cryptomining, and scam blocks
├── site/ # Minimalist text-based product website
│ ├── index.html # Website landing page
│ ├── features.html # Detailed 18 star features showcase
│ ├── privacy.html # Zero-data privacy policy document
│ ├── support.html # FAQ and community support portal
│ └── site.css # Shared minimalist text layout stylesheet
├── stubs/ # Secure analytics redirection mock scripts
│ └── ga.js # Google Analytics tracker override stub
├── background.js # Extension installation, update, and ruleset sync worker
├── content.js # Client-side smartlink sanitizers, anti-fingerprints, and popups block
├── cosmetic.css # Initial static ad element layout hiding rules
├── manifest.json # Extension permission, resources, and configurations
├── options.html # Settings Options Dashboard markup
├── options.js # Options settings dashboard actions and custom rules storage
├── picker.js # Interactive DOM click-to-block element picker
├── welcome.html # First-install onboarding guide
└── LICENSE # MIT license agreement
- Static Display Ad Blocking: DNR-based filtering of standard display banners, native placements, and sponsor widgets.
- Popunder & Redirect Protection: Hooks
window.opencalls on page contexts to block background tab-under ads. - Path-Based Ad Script Blocks: Target specific ad scripts (
/invoke.js) regardless of first-party domain cloaking. - Google Analytics Redirection: Intercepts Google Analytics tracking scripts and redirects them securely to local empty mocks (
ga.js), preventing page layout crashes. - Telemetry & Tracking Blocks: Disables background event logging libraries (Hotjar, Mixpanel, CrazyEgg).
- Social Pixel Mitigation: Prevents social platform pixels (Facebook, TikTok, Snapchat) from tracking users across pages.
- Anti-Adblock Defeater: Blocks scripts (like BlockAdBlock.js) from spawning anti-adblock blocking modals.
- Cryptominer Blocker: Blocks Coinhive and other CPU-draining browser-level mining endpoints.
- Phishing & Scam Shield: Active ruleset layer blocking over 70 known malicious phishing domains, lottery scams, and tech-support scams.
- HTTP-to-HTTPS Upgrades: DNR upgrades unencrypted HTTP requests to secure HTTPS automatically.
- Real-Time Badge Counters: Keeps tab-specific statistics of blocked network elements directly on the extension icon badge.
- Deterministic Whitelist Hashes: Hashes site domains to deterministic rule IDs, avoiding ruleset ID collisions.
- DOM Element Picker: Crosshair selector tool to highlight any element on page hover and hide it permanently.
- Settings Options Dashboard: Complete control center to write custom CSS hides, custom URL blocking rules, and whitelist sites.
- WebAccessible Resource Stubs: Securely registers redirection stubs to prevent cross-origin scripting errors.
- WebRTC IP Leak Protection: Prevents websites from leaking LAN/local IP addresses via WebRTC protocols.
- O(1) Smartlink Sanitizer: Capture-phase link click interception that instantly strips query parameter trackers.
- JS Cookie Guard: Restricts scripts from writing tracking cookies (like
_gaand_fbp) while preserving session integrity.
- Onboarding Page (
welcome.html): Opens automatically inside a new browser tab upon extension installation, helping users start quickly. - Product Website (
site/): A minimalist, fast-loading, emoji-free, dark-themed website detailing documentation, features, privacy policies, and support answers.
Install directly from the Chrome Web Store.
- Clone this repository locally.
- Open Google Chrome and navigate to
chrome://extensions/. - Toggle Developer mode (top right).
- Click Load unpacked (top left) and select the
ad-blockerdirectory. - Protection is active immediately!
This extension does not collect, log, or transmit any user data. All configuration settings, whitelisted domains, and cosmetic hiding overrides are stored and processed entirely on your local machine.
Distributed under the MIT License. See LICENSE for more details.