├── .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 |
--------------------------------------------------------------------------------