YouMode is an open-source, user-centric Google Chrome extension (Manifest V3) created by Anil G.C. Its single purpose is to provide high-performance, private, network-level ad blocking and optional cosmetic ad placeholder cleanup with precision per-site scoping.
Unlike conventional ad blockers that enforce all-or-nothing filtering, bundle commercial VPNs, or harvest browsing telemetry, YouMode gives users complete sovereignty over where and how ads are blocked. YouMode is engineered with an uncompromising 100% local-first privacy architecture:
When you browse the web with YouMode enabled:
chrome.declarativeNetRequest engine.chrome.storage.local)To preserve your configuration choices between browser restarts, YouMode stores minimal settings data locally on your device using Chrome's sandboxed chrome.storage.local API under the single key youmode_state.
Below is the complete, exhaustive schema of data stored on your device:
| Field Key | Data Type | Description & Purpose |
|---|---|---|
schemaVersion |
number |
Internal schema migration version (default: 1). |
settingsRevision |
number |
Monotonically increasing counter incremented when you change settings. |
appliedRevision |
number |
Revision confirmed applied within the browser's Declarative Net Request engine. |
pendingRevision |
number | null |
Tracks an in-progress settings transition (null when idle or verified). |
lastAppliedTimestamp |
number | null |
Unix timestamp (milliseconds) of the last successful engine verification. |
engineStatus |
string |
Operational status of the engine: 'off', 'applying', 'active', or 'error'. |
lastError |
string | null |
Diagnostic error string if a state transition fails (null when healthy). |
autoEnabled |
boolean |
Global Auto Mode toggle (starts false upon clean installation). |
manualSites |
string[] |
Array of canonical domain names explicitly selected for blocking in Manual Mode (e.g. ["example.com"]). |
autoPausedSites |
string[] |
Array of canonical domain names temporarily paused/whitelisted in Auto Mode (e.g. ["trusted-site.org"]). |
cleanupEnabled |
boolean |
Toggle for optional cosmetic ad placeholder hiding (starts false). |
Data Retention & Erasure: All stored configuration remains strictly within your browser's local profile directory. You can wipe all stored data at any time by opening the YouMode popup, clicking the Settings gear icon, and selecting "Reset All Settings", or by uninstalling YouMode from Chrome.
YouMode adheres strictly to Google's principle of least privilege. Every declared permission in manifest.json is essential to execute core ad-blocking capabilities:
| Permission | Technical Scope & Purpose |
|---|---|
declarativeNetRequest |
Core Network Ad-Blocking Engine: Instructs Chrome's native engine to block requests to known ad servers directly at the browser network layer using predefined rules. YouMode never intercepts, inspects, or reads your network request bodies, headers, or cookies. |
storage |
Local Settings Persistence: Saves your mode selections (autoEnabled), manual site list (manualSites), and paused exceptions (autoPausedSites) strictly in chrome.storage.local on your device.
|
activeTab |
Scoped Popup Inspection & Live Block Counter: Invoked strictly when you click the YouMode toolbar icon to open the popup. It temporarily grants permission to detect the current tab's hostname (e.g. example.com) to display the correct status (Active, Off, Paused, or Unsupported) and query chrome.declarativeNetRequest.getMatchedRules for that tab to show the real blocked request count. This data is held in-memory and is never written to disk, logged, or transmitted.
|
scripting |
Cosmetic Cleanup & Video Ad Mitigation: Allows the service worker to dynamically register and manage the cosmetic content script (content/cleanup.js) on active pages to collapse empty ad boxes and execute in-stream YouTube ad skip handling.
|
optional_host_permissions(http://*/*, https://*/*) |
Optional Cosmetic & Video Scope: Declared to allow cosmetic stylesheet injection and client-side ad skipping on websites where ad blocking is enabled. YouMode never accesses pages with restricted schemes (such as chrome://, the Chrome Web Store, or local file paths).
|
YouMode packages an audited static ruleset containing 27,333 rules precompiled inside the extension package at rules/core_rules.json. The rules are compiled offline during extension builds from trusted open-source filter lists:
All filter rules are sanitized during build compilation to guarantee that they never block top-level document navigations, modify HTTP headers, or redirect user traffic.
Because YouTube delivers legitimate media and video ads through identical *.googlevideo.com network endpoints, Declarative Net Request rules cannot intercept video ads without breaking regular video playback. YouMode resolves this locally within the tab via content/cleanup.js:
ad-showing) via a local MutationObserver and triggers an automatic click on YouTube's native Skip button (e.g. .ytp-ad-skip-button) within 1–2 milliseconds of it becoming available.isSafeSkipButton). YouMode never clicks sponsor links, advertiser cards, or external URLs (<a> elements with href).16.0x, cleanly restoring your regular playback speed (1.0x) and audio volume the moment your video resumes.currentTime) is never altered, and no watch history, video metadata, or channel names are ever recorded or transmitted.YouMode complies strictly with the Google Chrome Web Store User Data Policy, including the Limited Use requirements:
YouMode is designed for general audiences and does not knowingly collect, solicit, or store personal information from children under the age of 13 (or applicable age of digital consent in your jurisdiction), in compliance with the Children's Online Privacy Protection Act (COPPA). Because YouMode collects zero personal data from any user, no personal information belonging to children is ever processed.
Because all YouMode configuration data is stored locally in your browser profile, you retain complete sovereignty over your information at all times:
chrome://extensions) immediately and permanently deletes all extension settings, dynamic rules, and local storage from your device.We may update this Privacy Policy from time to time to reflect extension updates, technical enhancements, or changes in platform and legal requirements. Any updates will be published with a revised "Last Updated" date at the top of this page and committed to our official GitHub repository. We encourage users to review this page periodically.
If you have any questions, feedback, security disclosures, or privacy inquiries regarding YouMode, please contact us through our official public channels: