├── .github └── ISSUE_TEMPLATE │ ├── 01-bug-report.yaml │ ├── 02-feature-request.yaml │ ├── 03-question.yaml │ └── config.yml └── README.md /.github/ISSUE_TEMPLATE/01-bug-report.yaml: -------------------------------------------------------------------------------- 1 | name: 🐞 Bug report 2 | description: If you found something that we should know about 3 | labels: "Bug" 4 | body: 5 | - type: checkboxes 6 | attributes: 7 | label: Prerequisites 8 | description: | 9 | To avoid invalid reports, please check and confirm following checkboxes. 10 | It is highly recommended to use our [Web Reporting Tool](https://kb.adguard.com/en/technical-support/reporting-tool) instead of creating an issue on GitHub. 11 | options: 12 | - label: Filters were updated before reproducing an issue 13 | required: true 14 | - label: AdGuard Extra version is up-to-date 15 | required: true 16 | - label: I checked to make sure that this issue has not already been filed 17 | required: true 18 | - type: dropdown 19 | id: products 20 | attributes: 21 | label: What product do you use? 22 | multiple: true 23 | options: 24 | - AdGuard for iOS 25 | - AdGuard for Android 26 | - Adguard for Windows 27 | - Adguard for Mac 28 | - AdGuard Extra Extension 29 | - AdGuard Extra with other script manager 30 | validations: 31 | required: true 32 | 33 | - type: dropdown 34 | id: problem_type 35 | attributes: 36 | label: What type of problem have you encountered? 37 | description: If the problem does not fall under any category that is listed here, please contact our tech support - support@adguard.com 38 | multiple: true 39 | options: 40 | - Missed ads or ad leftovers 41 | - Website or app doesn't work properly 42 | - AdGuard Extra gets detected on a website 43 | validations: 44 | required: true 45 | 46 | - type: dropdown 47 | id: browsers 48 | attributes: 49 | label: Which browser(s) do you use? 50 | multiple: true 51 | options: 52 | - Firefox 53 | - Chrome 54 | - Safari 55 | - Microsoft Edge 56 | - Opera 57 | - Yandex Browser 58 | - other (specify in comment below) 59 | validations: 60 | required: true 61 | 62 | - type: input 63 | id: url 64 | attributes: 65 | label: Where is the problem encountered? 66 | description: Enter the web address or affected application link. 67 | placeholder: ex. https://example.com/ 68 | validations: 69 | required: true 70 | 71 | - type: dropdown 72 | id: filters 73 | attributes: 74 | label: What filters do you have enabled? 75 | description: Select enabled filters from the list or enter URLs of any custom filters in the comment field below. 76 | multiple: true 77 | options: 78 | - AdGuard Base filter 79 | - AdGuard Mobile Ads filter 80 | - AdGuard Chinese filter 81 | - AdGuard Dutch filter 82 | - AdGuard French filter 83 | - AdGuard German filter 84 | - AdGuard Japanese filter 85 | - AdGuard Russian filter 86 | - AdGuard Spanish/Portuguese filter 87 | - AdGuard Turkish filter 88 | - AdGuard Tracking Protection filter 89 | - AdGuard URL Tracking filter 90 | - AdGuard Social Media filter 91 | - AdGuard Annoyances filter 92 | - AdGuard Cookie Notices filter 93 | - AdGuard Popups filter 94 | - AdGuard Mobile App Banners filter 95 | - AdGuard Widgets filter 96 | - AdGuard Other Annoyances filter 97 | - AdGuard DNS filter 98 | - AdGuard Experimental filter 99 | - Filter unblocking search ads and self-promotion 100 | - ---Third-party filters--- 101 | - EasyList 102 | - ABPindo 103 | - Bulgarian list 104 | - EasyList China 105 | - EasyList Czech and Slovak 106 | - EasyList Dutch 107 | - EasyList Germany 108 | - EasyList Hebrew 109 | - EasyList Italy 110 | - EasyList Lithuania 111 | - Latvian List 112 | - Liste AR 113 | - Liste FR 114 | - ROList 115 | - EasyPrivacy 116 | - Icelandic ABP List 117 | - AdBlockID 118 | - Greek AdBlock Filter 119 | - Fanboy's Annoyances 120 | - Fanboy's Social Blocking List 121 | - Web Annoyances Ultralist 122 | - Thai Ads Filters 123 | - Hungarian filter 124 | - Peter Lowe's Blocklist 125 | - Xfiles 126 | - Adblock Warning Removal List 127 | - Online Malicious URL Blocklist 128 | - RU AdList - Counters 129 | - ABPVN List 130 | - Fanboy's Enhanced Tracking List 131 | - Official Polish filters for AdBlock, uBlock Origin & AdGuard 132 | - Polish GDPR-Cookies Filters 133 | - Estonian List 134 | - CJX's Annoyances List 135 | - Polish Social Filters 136 | - Fanboy's Anti-Facebook List 137 | - List-KR 138 | - xinggsf 139 | - I don't care about cookies 140 | - EasyList Spanish 141 | - KAD - Anti-Scam 142 | - Adblock List for Finland 143 | - ROLIST2 144 | - Iranian filter 145 | - road-block 146 | - Polish Annoyances Filters 147 | - Polish Anti Adblock Filters 148 | - Fanboy's Anti-thirdparty Fonts 149 | - EasyList Cookie List 150 | - NoCoin Filter List 151 | - Frellwit's Swedish Filter 152 | - YousList 153 | - AlleBlock 154 | - EasyList Polish 155 | - Polish Anti-Annoying Special Supplement 156 | - Dandelion Sprout's Nordic Filters 157 | - Dandelion Sprout's Annoyances List 158 | - Legitimate URL Shortener 159 | - Dandelion Sprout's Serbo-Croatian List 160 | - IndianList 161 | validations: 162 | required: true 163 | 164 | - type: textarea 165 | id: what-happened 166 | attributes: 167 | label: Issue Details 168 | description: Please provide a set of steps to reproduce the issue. 169 | placeholder: 170 | value: | 171 | Steps to reproduce: 172 | 1. 173 | 2. 174 | 3. 175 | validations: 176 | required: true 177 | 178 | - type: textarea 179 | id: how_it_should_be 180 | attributes: 181 | label: Expected Behavior 182 | placeholder: A clear and concise description of what you expected to happen. 183 | validations: 184 | required: false 185 | 186 | - type: textarea 187 | id: how_it_is 188 | attributes: 189 | label: Actual Behavior 190 | placeholder: A clear description of what happened instead. 191 | validations: 192 | required: true 193 | 194 | - type: textarea 195 | id: screens 196 | attributes: 197 | label: Screenshots 198 | description: | 199 | Add screenshots explaining your problem. 200 | You can drag and drop images or paste them from clipboard. 201 | Use `
` tag to hide screenshots under the spoiler. 202 | placeholder: If applicable add screenshots explaining your problem. 203 | value: | 204 |
Screenshot 1 205 | 206 | 207 | 208 |
209 | validations: 210 | required: true 211 | 212 | - type: textarea 213 | id: additional 214 | attributes: 215 | label: Additional Information 216 | placeholder: Add any other context about the problem here. 217 | validations: 218 | required: false 219 | 220 | - type: checkboxes 221 | id: terms 222 | attributes: 223 | label: Privacy 224 | description: By submitting this issue, you agree that report does not contain private info 225 | options: 226 | - label: I agree to follow this condition 227 | required: true 228 | -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/02-feature-request.yaml: -------------------------------------------------------------------------------- 1 | name: 🌱 Feature request 2 | description: If you know how AdGuard can be improved 3 | labels: "Feature request" 4 | body: 5 | - type: textarea 6 | id: what-happened 7 | attributes: 8 | label: Issue Details 9 | description: What happened? 10 | placeholder: Is your feature request related to a problem? Please add a clear and concise description of what the problem is. 11 | validations: 12 | required: true 13 | 14 | - type: textarea 15 | id: how_it_should_be 16 | attributes: 17 | label: Proposed solution 18 | description: 19 | placeholder: Describe the solution you'd like in a clear and concise manner. 20 | validations: 21 | required: true 22 | 23 | - type: textarea 24 | id: additional 25 | attributes: 26 | label: Alternative solution 27 | description: 28 | placeholder: A clear and concise description of any alternative solutions or features you've considered. 29 | validations: 30 | required: false -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/03-question.yaml: -------------------------------------------------------------------------------- 1 | name: ❓ Question 2 | description: If the options above do not work for you 3 | labels: "Question" 4 | body: 5 | - type: markdown 6 | attributes: 7 | value: Thanks for taking the time to fill out this form! 8 | 9 | - type: checkboxes 10 | attributes: 11 | label: Please answer the following questions for yourself before submitting a question. 12 | options: 13 | - label: I am running the latest version 14 | - label: I checked to make sure that this issue has not already been filed 15 | required: true 16 | 17 | - type: textarea 18 | id: question 19 | attributes: 20 | label: Ask a question 21 | placeholder: If you want to know more about how the userscript works. 22 | validations: 23 | required: true -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/config.yml: -------------------------------------------------------------------------------- 1 | 'blank_issues_enabled': true 2 | 'contact_links': 3 | - 'about': > 4 | Please report filtering issues, for example advertising filters 5 | misfiring or safe browsing false positives, using the form on our 6 | website 7 | 'name': 'AdGuard filters issues' 8 | 'url': 'https://link.adtidy.org/forward.html?action=report&from=github' 9 | - 'about': > 10 | Please check AdGuard Knowledgebase for more useful information about our products 11 | 'name': 'Knowledgebase' 12 | 'url': 'https://adguard.com/kb/' -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # AdGuard Extra 2 | 3 | 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. 4 | 5 | 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. 6 | However, if you want to use it alongside AdGuard browser extension or any other ad blocker, you'll need to use an additional extension. 7 | 8 | ## How to install AdGuard Extra 9 | 10 | ### Chrome or Chromium-based browser 11 | 12 | * **Stable version**: https://agrd.io/adguard_extra_chrome_release 13 | * Beta: https://agrd.io/adguard_extra_chrome_beta 14 | 15 | ### Firefox 16 | 17 | * **Stable version**: https://agrd.io/adguard_extra_firefox_release 18 | * Beta: https://agrd.io/adguard_extra_firefox_beta 19 | 20 | ### Userscript 21 | 22 | 1. Install Tampermonkey 23 | 2. Click the following link to install AdGuard Extra: https://userscripts.adtidy.org/release/adguard-extra/1.0/adguard-extra.user.js 24 | 25 | If you are using Tampermonkey version 5.1 or lower you need also change Inject Mode: 26 | 27 | 1. Open Settings and switch the mode to Advanced. 28 | 2. Scroll down the settings page and locate the Inject Mode option. 29 | 3. Change Inject Mode to Instant. 30 | 31 | Alternatively, you can install the beta version of AdGuard Extra userscript: https://userscripts.adtidy.org/beta/adguard-extra/1.0/adguard-extra.user.js 32 | 33 | ## How to exclude websites 34 | 35 | ### Userscript 36 | 37 | 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: 38 | ``` 39 | // @exclude *://example.com/* 40 | // @exclude *://*.example.com/* 41 | ``` 42 | 43 | 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. 44 | 45 | ### Extension 46 | 47 | AdGuard Extra extension can be restricted to specific websites in Chrome with `Allow site access` option of the extension settings. 48 | 49 | ## Important 50 | 51 | AdGuard Extra is a companion extension, it is supposed to be used with a full-scale ad blocker like AdGuard or any other. 52 | 53 | 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. 54 | 55 | Please note that it is only useful on a limited set of websites, and it does nothing on the websites not from this list. 56 | 57 | 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. 58 | 59 | * If you are using Tampermonkey, installation instructions can be found in [AdGuard Extra Userscript](https://github.com/AdguardTeam/AdGuardExtra?tab=readme-ov-file#userscript). 60 | 61 | * If you use the AdGuard apps for Mac and Windows, simply enable AdGuard Extra in the `Extensions` section. In AdGuard for Android, you can enable AdGuard Extra in the `Userscript` section `Settings --> Filtering --> Userscripts`. 62 | 63 | The repository provides a list of problematic sites labelled `problematic`. 64 | --------------------------------------------------------------------------------