├── .github ├── ISSUE_TEMPLATE │ ├── config.yml │ ├── 03-question.yaml │ ├── 02-feature-request.yaml │ └── 01-bug-report.yaml └── stale.yml └── README.md /.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&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/' 13 | -------------------------------------------------------------------------------- /.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 app works. 22 | validations: 23 | required: true -------------------------------------------------------------------------------- /.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 | - 'Bug' 8 | - 'Compatibility' 9 | - 'Enhancement' 10 | - 'Feature Request' 11 | - 'Feature_Request' 12 | - 'feature request' 13 | - 'feature_request' 14 | - 'Localization' 15 | # Label to use when marking an issue as stale 16 | staleLabel: 'Wontfix' 17 | # Comment to post when marking an issue as stale. Set to `false` to disable 18 | markComment: > 19 | This issue has been automatically marked as stale because it has not had 20 | recent activity. It will be closed if no further activity occurs. Thank you 21 | for your contributions. 22 | # Comment to post when closing a stale issue. Set to `false` to disable 23 | closeComment: false 24 | -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/02-feature-request.yaml: -------------------------------------------------------------------------------- 1 | --- 2 | 3 | name: 🌱 Feature request 4 | description: Create a feature request to help us improve AdGuard for Mac. 5 | labels: ['Feature request'] 6 | body: 7 | - type: textarea 8 | id: what-happened 9 | attributes: 10 | label: Issue Details 11 | description: What happened? 12 | placeholder: Is your feature request related to a problem? Please add a clear and concise description of what the problem is. 13 | validations: 14 | required: false 15 | - type: textarea 16 | id: how_it_should_be 17 | attributes: 18 | label: Proposed solution 19 | description: 20 | placeholder: Describe the solution you'd like in a clear and concise manner. 21 | validations: 22 | required: false 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 | - type: markdown 32 | attributes: 33 | value: | 34 | --- 35 | Upvote [important issues](https://github.com/AdguardTeam/AdguardForMac/issues?q=is%3Aissue+is%3Aopen+sort%3Areactions-%2B1-desc+) with a :+1: -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 |

2 | 3 | 4 | AdGuard for Mac 5 | 6 |

7 |

The most advanced system-wide content blocker for Mac

8 |

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

11 | 12 |

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

18 | 20 | 21 | Latest release 22 | 23 | 24 | Beta version> 25 | 26 | 27 | 28 | * [Contribution](#contribution) 29 | * [How to report an issue](#issue) 30 | * [Translating AdGuard](#contribution-translating) 31 | * [Other options](#contribution-other) 32 | * [How to become a Beta tester](#beta-tester) 33 | * [Our plans](#our-plans) 34 | 35 | > ### Disclaimer 36 | >* AdGuard for Mac 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). 37 | >* Privacy policy: https://adguard.com/privacy/mac.html (Briefly: AdGuard sends only necessary, limited information, e.g. information required for a license check). 38 | 39 | AdGuard is the only standalone ad blocker app for Mac that can block ads equally well in all browsers and apps, not only in Safari. It will also protect your data from tracking and shield your privacy. 40 | 41 | To get more information and to download AdGuard for Mac, visit our website [https://adguard.com/](https://adguard.com/adguard-mac/overview.html). 42 | 43 | 44 | 45 | 46 | 47 | 48 | 49 | 50 | 51 | 52 | 53 | ## Contribution 54 | 55 | 56 | ### How to report an issue? 57 | 58 | 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/AdguardForMac/issues) and click the *New issue* button. 59 | 60 | >**Note:** for the filter-related issues (missed ads, false positives etc.) use our [reporting tool](https://kb.adguard.com/technical-support/reporting-tool#mac). 61 | 62 | 63 | ### Translating AdGuard 64 | 65 | If you want to help with AdGuard translations, please learn more about translating our products here: https://kb.adguard.com/en/general/adguard-translations 66 | 67 | 68 | ### Other options 69 | 70 | Here is a [dedicated page](https://adguard.com/contribute.html) for those who are willing to contribute. 71 | 72 | 73 | 74 | ### How to become a beta tester? 75 | 76 | You can submit an application to participate in AdGuard for Mac beta-testing program. All necessary information on this topic can be found on the [dedicated page](https://adguard.com/beta.html). 77 | 78 | 79 | ## Our plans 80 | 81 | To see the "big picture", to watch current progress and to get an idea of approximate dates for upcoming AdGuard for Mac releases, see this page: https://github.com/AdguardTeam/AdGuardforMac/milestones 82 | -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/01-bug-report.yaml: -------------------------------------------------------------------------------- 1 | --- 2 | 3 | name: 🐞 Bug report 4 | description: If you found something that we should know about 5 | labels: [Bug] 6 | body: 7 | - type: markdown 8 | attributes: 9 | value: | 10 | Thanks for taking the time to fill out this bug report! 11 | - type: checkboxes 12 | attributes: 13 | label: Please answer the following questions for yourself before submitting an issue 14 | options: 15 | - label: Filters were updated before reproducing an issue 16 | required: true 17 | - label: I checked the [knowledge base](https://adguard.com/kb/) and found no answer 18 | required: true 19 | - label: I checked to make sure that this issue has not already been filed 20 | required: true 21 | 22 | - type: input 23 | id: app_version 24 | attributes: 25 | label: AdGuard version 26 | description: What version of our application are you running? 27 | placeholder: For example, 2.14.1 release 28 | validations: 29 | required: true 30 | - type: input 31 | id: br_version 32 | attributes: 33 | label: Browser version 34 | description: What browser do you use? 35 | placeholder: For example, Safari 17 36 | validations: 37 | required: false 38 | - type: input 39 | id: os_version 40 | attributes: 41 | label: OS version 42 | description: What operating system do you use? 43 | placeholder: For example, macOS Sonoma 14.5 44 | validations: 45 | required: true 46 | 47 | - type: markdown 48 | attributes: 49 | value: "### What filters do you have enabled?" 50 | 51 | - type: markdown 52 | attributes: 53 | value: | 54 | Select enabled filters if they are related to the application bug. 55 | If the issue is related to the filtering (missed ads, cookie, etc.) 56 | use the [Web Reporting Tool](https://kb.adguard.com/technical-support/reporting-tool) please. 57 | 58 | - type: dropdown 59 | id: filters_adblock 60 | attributes: 61 | label: Ad Blocking 62 | multiple: true 63 | options: 64 | - AdGuard Base filter 65 | - AdGuard Mobile Ads filter 66 | - EasyList 67 | validations: 68 | required: false 69 | 70 | - type: dropdown 71 | id: filters_privacy 72 | attributes: 73 | label: Privacy 74 | multiple: true 75 | options: 76 | - AdGuard Tracking Protection filter 77 | - AdGuard URL Tracking filter 78 | - EasyPrivacy 79 | - Legitimate URL Shortener 80 | - Peter Lowe's Blocklist 81 | - Fanboy's Anti-Facebook List 82 | validations: 83 | required: false 84 | 85 | - type: dropdown 86 | id: filters_social 87 | attributes: 88 | label: Social 89 | multiple: true 90 | options: 91 | - AdGuard Social Media filter 92 | - Fanboy's Social Blocking List 93 | validations: 94 | required: false 95 | 96 | - type: dropdown 97 | id: filters_annoyances 98 | attributes: 99 | label: Annoyances 100 | multiple: true 101 | options: 102 | - AdGuard Annoyances filter 103 | - AdGuard Cookie Notices filter 104 | - AdGuard Popups filter 105 | - AdGuard Mobile App Banners filter 106 | - AdGuard Other Annoyances filter 107 | - AdGuard Widgets filter 108 | - Adblock Warning Removal List 109 | - Fanboy's Annoyances 110 | - EasyList Cookie List 111 | - Dandelion Sprout's Annoyances List 112 | validations: 113 | required: false 114 | 115 | - type: dropdown 116 | id: filters_security 117 | attributes: 118 | label: Security 119 | multiple: true 120 | options: 121 | - Online Malicious URL Blocklist 122 | - Phishing URL Blocklist 123 | - Scam Blocklist by DurableNapkin 124 | - uBlock Origin – Badware risks 125 | - NoCoin Filter List 126 | validations: 127 | required: false 128 | 129 | - type: dropdown 130 | id: filters_other 131 | attributes: 132 | label: Other 133 | multiple: true 134 | options: 135 | - Filter unblocking search ads and self-promotion 136 | - AdGuard DNS filter 137 | - AdGuard Experimental filter 138 | - Fanboy's Anti-thirdparty Fonts 139 | validations: 140 | required: false 141 | 142 | - type: dropdown 143 | id: filters_regional 144 | attributes: 145 | label: Language-specific 146 | multiple: true 147 | options: 148 | - AdGuard Chinese filter 149 | - AdGuard Dutch filter 150 | - AdGuard French filter 151 | - AdGuard German filter 152 | - AdGuard Japanese filter 153 | - AdGuard Russian filter 154 | - AdGuard Spanish/Portuguese filter 155 | - AdGuard Turkish filter 156 | - AdGuard Ukrainian filter 157 | - ABPindo 158 | - ABPVN List 159 | - Adblock List for Finland 160 | - AdBlockID 161 | - Bulgarian list 162 | - CJX's Annoyances List 163 | - Dandelion Sprout's Nordic Filters 164 | - Dandelion Sprout's Serbo-Croatian List 165 | - EasyList China 166 | - EasyList Czech and Slovak 167 | - EasyList Dutch 168 | - EasyList Germany 169 | - EasyList Hebrew 170 | - EasyList Italy 171 | - EasyList Lithuania 172 | - EasyList Polish 173 | - EasyList Portuguese 174 | - EasyList Spanish 175 | - EasyList Thailand 176 | - Estonian List 177 | - Frellwit's Swedish Filter 178 | - Greek AdBlock Filter 179 | - Hungarian filter 180 | - Icelandic ABP List 181 | - IndianList 182 | - KAD - Anti-Scam 183 | - Latvian List 184 | - List-KR 185 | - Liste AR 186 | - Liste FR 187 | - Macedonian adBlock Filters 188 | - Official Polish filters for AdBlock, uBlock Origin & AdGuard 189 | - Persian Blocker 190 | - Polish Annoyances Filters 191 | - Polish Anti Adblock Filters 192 | - Polish Anti-Annoying Special Supplement 193 | - Polish GDPR-Cookies Filters 194 | - Polish Social Filters 195 | - road-block light 196 | - ROList 197 | - ROLIST2 198 | - RU AdList - Counters 199 | - Xfiles 200 | - xinggsf 201 | - YousList 202 | validations: 203 | required: false 204 | 205 | - type: dropdown 206 | id: dns_protection 207 | attributes: 208 | label: Which DNS server do you use? 209 | multiple: false 210 | options: 211 | - DNS protection disabled 212 | - System default DNS 213 | - AdGuard DNS 214 | - AdGuard DNS Family Protection 215 | - AdGuard DNS Non-filtering 216 | - Google DNS 217 | - Cloudflare DNS 218 | - Cloudflare for Families - Malware and Adult Content 219 | - Cloudflare for Families - Malware Blocking 220 | - Open DNS 221 | - Open DNS with Family Shield 222 | - Quad9 223 | - Custom DNS 224 | validations: 225 | required: true 226 | 227 | - type: dropdown 228 | id: dns_protocol 229 | attributes: 230 | label: DNS protocol 231 | multiple: false 232 | options: 233 | - Regular 234 | - DNSCrypt 235 | - DNS-over-HTTPS 236 | - DNS-over-TLS 237 | - DNS-over-QUIC 238 | validations: 239 | required: false 240 | 241 | - type: textarea 242 | id: custom_dns 243 | attributes: 244 | label: Custom DNS 245 | description: Please provide a link to the custom DNS you use 246 | placeholder: If you have enabled DNS from the pre-defined list, skip this 247 | validations: 248 | required: false 249 | - type: dropdown 250 | id: stealth 251 | attributes: 252 | label: What Stealth Mode options do you have enabled? 253 | description: Select any of these options if you have them enabled in Stealth Mode. 254 | multiple: true 255 | options: 256 | - Block trackers 257 | - Remove tracking parameters 258 | - Hide your search queries 259 | - Send Do-Not-Track signals 260 | - Self-destruction of third-party cookies 261 | - Self-destruction of first-party cookies 262 | - Disable cache for third-party requests 263 | - Block the third-party Authorization header 264 | - Block WebRTC 265 | - Block Push API 266 | - Block Location API 267 | - Block Java 268 | - Hide your Referrer from third-parties 269 | - Hide your User Agent 270 | - Mask your IP address 271 | - Remove X-client-Data header from HTTP request 272 | - Protect from DPI 273 | 274 | - type: input 275 | id: customer_id 276 | attributes: 277 | label: Support ticket ID 278 | description: If you've already sent us a diagnostic report through the application, share the ticket ID number. You can find it in an auto-reply email from AdGuard support after sending a report. 279 | placeholder: Enter a ticket ID 280 | validations: 281 | required: false 282 | 283 | - type: textarea 284 | id: what-happened 285 | attributes: 286 | label: Issue Details 287 | description: Please provide a set of steps to reproduce the issue. 288 | placeholder: 289 | value: | 290 | Steps to reproduce: 291 | 1. 292 | 2. 293 | 3. 294 | validations: 295 | required: true 296 | 297 | - type: textarea 298 | id: how_it_should_be 299 | attributes: 300 | label: Expected Behavior 301 | placeholder: A clear and concise description of what you expected to happen. 302 | validations: 303 | required: false 304 | 305 | - type: textarea 306 | id: how_it_is 307 | attributes: 308 | label: Actual Behavior 309 | placeholder: A clear description of what happened instead. 310 | validations: 311 | required: true 312 | 313 | - type: textarea 314 | id: screens 315 | attributes: 316 | label: Screenshots 317 | description: | 318 | If applicable add screenshots explaining your problem. 319 | You can drag and drop images or paste them from clipboard. 320 | Use `

` tag to hide screenshots under the spoiler. 321 | placeholder: If applicable add screenshots explaining your problem. 322 | value: | 323 |
Screenshot 1 324 | 325 | 326 | 327 |
328 | validations: 329 | required: false 330 | 331 | - type: textarea 332 | id: additional 333 | attributes: 334 | label: Additional Information 335 | placeholder: Add any other context about the problem here. 336 | validations: 337 | required: false 338 | 339 | - type: markdown 340 | attributes: 341 | value: | 342 | --- 343 | Upvote [important issues](https://github.com/AdguardTeam/AdguardForMac/issues?q=is%3Aissue+is%3Aopen+sort%3Areactions-%2B1-desc+) with a :+1: --------------------------------------------------------------------------------