AdguardTeam / AdGuardExtra

AdGuard Extra is designed to solve complicated cases when regular ad blocking rules aren't enough.
640 stars 18 forks source link
adblock-circumvention adguard userscript

AdGuard Extra

AdGuard Extra is a userscript (or a browser extension) that is supposed to fight ad blocking circumvention attempts which become more and more and popular. Regular ad blocking rules do not allow us being as flexible as it's necessary, that's why AdGuard Extra was developed.

AdGuard Extra comes pre-installed with all premium AdGuard apps, which support userscripts, i.e for AdGuard for Windows, AdGuard for Mac, and AdGuard for Android you won't need to do anything to use it. However, if you want to use it alongside AdGuard browser extension or any other ad blocker, you'll need to use an additional extension.

How to install AdGuard Extra

Chrome or Chromium-based browser

Firefox

Userscript

  1. Install Tampermonkey
  2. Click the following link to install AdGuard Extra: https://userscripts.adtidy.org/release/adguard-extra/1.0/adguard-extra.user.js

If you are using Tampermonkey version 5.1 or lower you need also change Inject Mode:

  1. Open Settings and switch the mode to Advanced.
  2. Scroll down the settings page and locate the Inject Mode option.
  3. Change Inject Mode to Instant.

Alternatively, you can install the beta version of AdGuard Extra userscript: https://userscripts.adtidy.org/beta/adguard-extra/1.0/adguard-extra.user.js

How to exclude websites

Userscript

You can restrict userscript from working on certain websites by adding @exclude rule to the userscript header. For example, to exclude example.com, you should add the following line to the userscript header:

// @exclude  *://example.com/*
// @exclude *://*.example.com/*

When using Tampermonkey, you can also use the built-in editor to add the rule. To do so, open the userscript settings, and add the pattern to the Blacklisted Pages field of Security section.

Extension

AdGuard Extra extension can be restricted to specific websites in Chrome with Allow site access option of the extension settings.

Important

AdGuard Extra is a companion extension, it is supposed to be used with a full-scale ad blocker like AdGuard or any other.

It provides no user interface save for the extension icon in the toolbar. Your browser should allow you to hide the icon if it annoys you.

Please note that it is only useful on a limited set of websites, and it does nothing on the websites not from this list.

For problematic sites that change their code frequently, the solution is only included in the AdGuard Extra Userscript version. This version can be installed via Tampermonkey or via the AdGuard app for Mac, Windows or Android.

The repository provides a list of problematic sites labelled problematic.