├── .github ├── ISSUE_TEMPLATE │ ├── 01-bug-report.yaml │ ├── 02-feature-request.yaml │ ├── 03-question.yaml │ └── config.yml └── stale.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: markdown 6 | attributes: 7 | value: Thanks for taking the time to fill out this bug report! 8 | - type: checkboxes 9 | attributes: 10 | label: Please answer the following questions for yourself before submitting an issue 11 | options: 12 | - label: Filters were updated before reproducing an issue 13 | required: true 14 | - label: I checked the [knowledge base](https://adguard.com/kb/) and found no answer 15 | required: true 16 | - label: I checked to make sure that this issue has not already been filed 17 | required: true 18 | 19 | - type: input 20 | id: app_version 21 | attributes: 22 | label: AdGuard version 23 | description: What version of our application are you running? 24 | placeholder: For example, 4.3.1 25 | validations: 26 | required: true 27 | 28 | - type: textarea 29 | id: enviroment 30 | attributes: 31 | label: Environment 32 | description: | 33 | examples: 34 | - **OS version**: Android 14 35 | - **Device**: Huawei P50 Pro 36 | value: | 37 | - OS version: 38 | - Device: 39 | validations: 40 | required: true 41 | 42 | - type: checkboxes 43 | attributes: 44 | label: HTTPS filtering 45 | description: Do you have HTTPS filtering enabled? 46 | options: 47 | - label: yes, I do 48 | validations: 49 | required: false 50 | 51 | - type: checkboxes 52 | attributes: 53 | label: Root access 54 | description: Do you have root privileges? 55 | options: 56 | - label: yes, I have it 57 | validations: 58 | required: false 59 | 60 | - type: checkboxes 61 | attributes: 62 | label: Integration with AdGuard VPN 63 | description: Do you have integrated mode enabled in AdGuard VPN app? 64 | options: 65 | - label: yes, I do 66 | validations: 67 | required: false 68 | 69 | - type: dropdown 70 | id: routing_mode 71 | attributes: 72 | label: Routing mode 73 | multiple: false 74 | options: 75 | - Local VPN 76 | - Automatic proxy 77 | - Manual proxy 78 | validations: 79 | required: true 80 | 81 | - type: markdown 82 | attributes: 83 | value: "### What filters do you have enabled?" 84 | 85 | - type: markdown 86 | attributes: 87 | value: | 88 | Select enabled filters if they are related to the application bug. 89 | If the issue is related to the filtering (missed ads, cookie, etc.) 90 | use the [Web Reporting Tool](https://kb.adguard.com/technical-support/reporting-tool) please. 91 | 92 | - type: dropdown 93 | id: filters_adblock 94 | attributes: 95 | label: Ad Blocking 96 | multiple: true 97 | options: 98 | - AdGuard Base filter 99 | - AdGuard Mobile Ads filter 100 | - EasyList 101 | validations: 102 | required: false 103 | 104 | - type: dropdown 105 | id: filters_privacy 106 | attributes: 107 | label: Privacy 108 | multiple: true 109 | options: 110 | - AdGuard Tracking Protection filter 111 | - AdGuard URL Tracking filter 112 | - EasyPrivacy 113 | - Legitimate URL Shortener 114 | - Peter Lowe's Blocklist 115 | - Fanboy's Anti-Facebook List 116 | - Fanboy's Anti-thirdparty Fonts 117 | validations: 118 | required: false 119 | 120 | - type: dropdown 121 | id: filters_social 122 | attributes: 123 | label: Social 124 | multiple: true 125 | options: 126 | - AdGuard Social Media filter 127 | - Fanboy's Social Blocking List 128 | validations: 129 | required: false 130 | 131 | - type: dropdown 132 | id: filters_annoyances 133 | attributes: 134 | label: Annoyances 135 | multiple: true 136 | options: 137 | - AdGuard Annoyances filter 138 | - AdGuard Cookie Notices filter 139 | - AdGuard Popups filter 140 | - AdGuard Mobile App Banners filter 141 | - AdGuard Other Annoyances filter 142 | - AdGuard Widgets filter 143 | - Adblock Warning Removal List 144 | - Fanboy's Annoyances 145 | - I don't care about cookies 146 | - EasyList Cookie List 147 | - Dandelion Sprout's Annoyances List 148 | validations: 149 | required: false 150 | 151 | - type: dropdown 152 | id: filters_security 153 | attributes: 154 | label: Security 155 | multiple: true 156 | options: 157 | - Online Malicious URL Blocklist 158 | - NoCoin Filter List 159 | validations: 160 | required: false 161 | 162 | - type: dropdown 163 | id: filters_regional 164 | attributes: 165 | label: Language-specific 166 | multiple: true 167 | options: 168 | - AdGuard Chinese filter 169 | - AdGuard Dutch filter 170 | - AdGuard French filter 171 | - AdGuard German filter 172 | - AdGuard Japanese filter 173 | - AdGuard Russian filter 174 | - AdGuard Spanish/Portuguese filter 175 | - AdGuard Turkish filter 176 | - AdGuard Ukrainian filter 177 | - ABPindo 178 | - ABPVN List 179 | - Adblock List for Finland 180 | - AdBlockID 181 | - Bulgarian list 182 | - CJX's Annoyances List 183 | - Dandelion Sprout's Nordic Filters 184 | - Dandelion Sprout's Serbo-Croatian List 185 | - EasyList China 186 | - EasyList Czech and Slovak 187 | - EasyList Dutch 188 | - EasyList Germany 189 | - EasyList Hebrew 190 | - EasyList Italy 191 | - EasyList Lithuania 192 | - EasyList Polish 193 | - EasyList Portuguese 194 | - EasyList Spanish 195 | - EasyList Thailand 196 | - Estonian List 197 | - Frellwit's Swedish Filter 198 | - Greek AdBlock Filter 199 | - Hungarian filter 200 | - Icelandic ABP List 201 | - IndianList 202 | - KAD - Anti-Scam 203 | - Latvian List 204 | - List-KR 205 | - Liste AR 206 | - Liste FR 207 | - Macedonian adBlock Filters 208 | - Official Polish filters for AdBlock, uBlock Origin & AdGuard 209 | - Persian Blocker 210 | - Polish Annoyances Filters 211 | - Polish Anti Adblock Filters 212 | - Polish Anti-Annoying Special Supplement 213 | - Polish GDPR-Cookies Filters 214 | - Polish Social Filters 215 | - road-block light 216 | - ROList 217 | - ROLIST2 218 | - RU AdList - Counters 219 | - Xfiles 220 | - xinggsf 221 | - YousList 222 | validations: 223 | required: false 224 | 225 | - type: dropdown 226 | id: filters_other 227 | attributes: 228 | label: Other 229 | multiple: true 230 | options: 231 | - Filter unblocking search ads and self-promotion 232 | - AdGuard DNS filter 233 | - AdGuard Experimental filter 234 | validations: 235 | required: false 236 | 237 | - type: dropdown 238 | id: dns_protection 239 | attributes: 240 | label: Which DNS server do you use? 241 | multiple: false 242 | options: 243 | - DNS protection disabled 244 | - Automatic DNS 245 | - AdGuard DNS 246 | - AdGuard DNS Family Protection 247 | - AdGuard DNS Non-filtering 248 | - Google DNS 249 | - Cloudflare DNS 250 | - Cloudflare for Families - Malware and Adult Content 251 | - Cloudflare for Families - Malware Blocking 252 | - Open DNS 253 | - Open DNS with Family Shield 254 | - Quad9 255 | - Custom DNS 256 | validations: 257 | required: true 258 | 259 | - type: dropdown 260 | id: dns_protocol 261 | attributes: 262 | label: DNS protocol 263 | multiple: false 264 | options: 265 | - Regular 266 | - DNSCrypt 267 | - DNS-over-HTTPS 268 | - DNS-over-TLS 269 | - DNS-over-QUIC 270 | validations: 271 | required: false 272 | 273 | - type: textarea 274 | id: custom_dns 275 | attributes: 276 | label: Custom DNS 277 | description: Please provide a link to the custom DNS you use 278 | placeholder: If you have enabled DNS from the pre-defined list, skip this 279 | validations: 280 | required: false 281 | 282 | - type: dropdown 283 | id: stealth 284 | attributes: 285 | label: What Stealth Mode options do you have enabled? 286 | description: Select any of these options if you have them enabled in Stealth Mode. You can skip this step if it's not relevant. 287 | multiple: true 288 | options: 289 | - Block trackers 290 | - Remove tracking parameters from URLs 291 | - Hide your search queries 292 | - Ask websits not to track you 293 | - Self-destruction of third-party cookies 294 | - Self-destruction of first-party cookies 295 | - Block ETag and If-None-Match headers 296 | - Block the third-party Authorization header 297 | - Disable WebRTC 298 | - Block Push API 299 | - Block Location API 300 | - Hide your Referrer from third-parties 301 | - Hide your User Agent 302 | - Hide your IP address 303 | - Remove X-client-Data header from HTTP request 304 | - Protect against DPI 305 | 306 | - type: textarea 307 | id: what-happened 308 | attributes: 309 | label: Issue Details 310 | description: Please provide a set of steps to reproduce the issue. 311 | placeholder: 312 | value: | 313 | Steps to reproduce: 314 | 1. 315 | 2. 316 | 3. 317 | validations: 318 | required: true 319 | 320 | - type: textarea 321 | id: how_it_should_be 322 | attributes: 323 | label: Expected Behavior 324 | placeholder: A clear and concise description of what you expected to happen. 325 | validations: 326 | required: false 327 | 328 | - type: textarea 329 | id: how_it_is 330 | attributes: 331 | label: Actual Behavior 332 | placeholder: A clear description of what happened instead. 333 | validations: 334 | required: true 335 | 336 | - type: textarea 337 | id: screens 338 | attributes: 339 | label: Screenshots 340 | description: | 341 | If applicable add screenshots explaining your problem. 342 | You can drag and drop images or paste them from clipboard. 343 | Use `
` tag to hide screenshots under the spoiler. 344 | placeholder: If applicable add screenshots explaining your problem. 345 | value: | 346 |
Screenshot 1 347 | 348 | 349 | 350 |
351 | validations: 352 | required: false 353 | 354 | - type: textarea 355 | id: additional 356 | attributes: 357 | label: Additional Information 358 | placeholder: Add any other context about the problem here. 359 | validations: 360 | required: false 361 | 362 | - type: markdown 363 | attributes: 364 | value: | 365 | --- 366 | Upvote [important issues](https://github.com/AdguardTeam/AdguardForAndroid/issues?q=is%3Aissue+is%3Aopen+sort%3Areactions-%2B1-desc+) with a :+1: -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/02-feature-request.yaml: -------------------------------------------------------------------------------- 1 | name: 🌱 Feature request 2 | description: If you know how AdGuard for Android 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 31 | 32 | - type: markdown 33 | attributes: 34 | value: | 35 | --- 36 | Upvote [important issues](https://github.com/AdguardTeam/AdguardForAndroid/issues?q=is%3Aissue+is%3Aopen+sort%3Areactions-%2B1-desc+) with a :+1: -------------------------------------------------------------------------------- /.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 the [knowledge base](https://adguard.com/kb/) and found no answer 15 | required: true 16 | - label: I checked to make sure that this issue has not already been filed 17 | required: true 18 | 19 | - type: textarea 20 | id: question 21 | attributes: 22 | label: Ask a question 23 | placeholder: If you want to know more about how the app works. 24 | validations: 25 | 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.net/forward.html?action=report&app=home&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/' -------------------------------------------------------------------------------- /.github/stale.yml: -------------------------------------------------------------------------------- 1 | # Number of days of inactivity before an issue becomes stale 2 | daysUntilStale: 60 3 | # Number of days of inactivity before a stale issue is closed 4 | daysUntilClose: 7 5 | # Issues with these labels will never be considered stale 6 | exemptLabels: 7 | - 'Android bug' 8 | - 'Bug' 9 | - 'Compatibility' 10 | - 'Enhancement' 11 | - 'Feature Request' 12 | - 'Feature_Request' 13 | - 'feature request' 14 | - 'feature_request' 15 | - 'Localization' 16 | # Label to use when marking an issue as stale 17 | staleLabel: 'Wontfix' 18 | # Comment to post when marking an issue as stale. Set to `false` to disable 19 | markComment: > 20 | This issue has been automatically marked as stale because it has not had 21 | recent activity. It will be closed if no further activity occurs. Thank you 22 | for your contributions. 23 | # Comment to post when closing a stale issue. Set to `false` to disable 24 | closeComment: false 25 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 |   2 |

3 | 4 | 5 | AdGuard for Android 6 | 7 |

8 |

The most advanced system-wide content blocker for Android

9 |

10 | All-round protection from all kinds of online ads, tracking and malvertising. 11 |

12 | 13 |

14 | Website | 15 | Reddit | 16 | Twitter | 17 | Telegram 18 |

19 | 20 | 21 | 22 | 23 | 24 | 25 |
26 | 27 | 28 | 29 | 30 | 31 | 32 |
33 | 34 | Latest release 35 | 36 | 37 | Beta version> 38 | 39 |

40 | 41 |   42 |

43 | 44 | Explore it on AppGallery 45 | 46 |   47 | 48 | Get it on Mi App Mall 49 | 50 |   51 | 52 | Available on Galaxy Store 53 | 54 |

55 | 56 | 57 |   58 | * [Contribution](#contribution) 59 | * [How to report an issue](#issue) 60 | * [Translating AdGuard](#contribution-translating) 61 | * [Other options](#contribution-other) 62 | * [How to become a Beta tester](#beta-tester) 63 | * [Our plans](#our-plans) 64 | 65 | > ### Disclaimer 66 | >* AdGuard for Android is not an open source project. We use GitHub as an open bug tracker for users to see what developers are working on. However, we at AdGuard create [a lot of open source software](https://github.com/search?o=desc&q=topic%3Aopen-source+org%3AAdguardTeam+fork%3Atrue&s=stars&type=Repositories). 67 | >* Privacy policy: https://adguard.com/privacy/android.html (Briefly: AdGuard sends only necessary, limited information, e.g. information required for a license check). 68 | 69 | AdGuard is a unique tool that blocks ads in apps and browsers even without ROOT privileges, protects your privacy, and helps you manage your apps. AdGuard gives you options of running it either VPN or HTTP proxy mode and allows to set up custom DNS settings (with DNSCrypt support). 70 | 71 | To get more information and to download AdGuard for Android, visit our website [https://adguard.com/](https://adguard.com/adguard-android/overview.html). 72 | 73 |

74 | 75 | 76 | 77 | 78 | 79 | 80 | 81 | 82 | 83 | 84 | 85 | 86 |

87 | 88 | 89 | ## Contribution 90 | 91 | 92 | ### How to report an issue? 93 | 94 | GitHub can be used to report a bug or to submit a feature request. To do so, go to [this page](https://github.com/AdguardTeam/AdguardForAndroid/issues) and click the *New issue* button. 95 | 96 | >**Note:** for the filter-related issues (missed ads, false positives etc.) use our [reporting tool](https://reports.adguard.com/new_issue.html). 97 | 98 | 99 | ### Translating AdGuard 100 | 101 | If you want to help with AdGuard translations, please learn more about translating our products here: https://kb.adguard.com/en/general/adguard-translations 102 | 103 | 104 | ### Other options 105 | 106 | Here is a [dedicated page](https://adguard.com/contribute.html) for those who are willing to contribute. 107 | 108 | 109 | 110 | ### How to become a beta tester? 111 | 112 | You can submit an application to participate in AdGuard for Android beta-testing program. All necessary information on this topic can be found on the [dedicated page](https://adguard.com/beta.html). 113 | 114 | 115 | ## Our plans 116 | 117 | To see the 'big picture', to watch current progress and to get an idea of approximate dates for upcoming AdGuard for Android releases, see this page: https://github.com/AdguardTeam/AdguardForAndroid/milestones 118 | --------------------------------------------------------------------------------