AdguardTeam

AdguardTeam/AdGuardMiniForMac

AdGuard Mini for macOS

View on GitHub Website / Demo Back to listing

1.2kstars 83forks 21contributors Swift

README.md

<h3 align="center">The most advanced ad blocking extension for Safari</h3>

 Free and open source, highly customizable and lightning fast ad blocking extension.

<a href="https://adguard.com/adguard-mini-mac/overview.html">Website</a> |
 <a href="https://reddit.com/r/Adguard">Reddit</a> |
 <a href="https://x.com/AdGuard">X</a> |
 <a href="https://t.me/adguard_en">Telegram</a>
 
 <a href="https://agrd.io/mini_mac"><img src="https://img.shields.io/badge/download-app%20store-blue.svg" alt="Download on the App Store" /></a>
 <a href="https://agrd.io/adguard_mini_for_mac"><img src="https://img.shields.io/github/release/AdguardTeam/AdGuardMiniForMac.svg?label=release&filter=%2Arelease" alt="Release version" /></a>
 <a href="https://agrd.io/adguard_mini_for_mac_beta"><img src="https://img.shields.io/github/release/AdguardTeam/AdGuardMiniForMac.svg?label=beta&filter=%2Abeta&color=orange" alt="Beta version" /></a>
 <a href="https://agrd.io/adguard_mini_for_mac_nightly"><img src="https://img.shields.io/github/tag-pre/AdguardTeam/AdGuardMiniForMac.svg?label=nightly&filter=%2Anightly&color=green" alt="Nightly version" /></a>

 

 <picture>
 <source media="(prefers-color-scheme: dark)" srcset="https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/ag-mini-gh-dark.png" width="800">
 <img src="https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/ag-mini-gh.png" width="800">
 </picture>

- [Key features](#key)
- [Advanced features](#pro)
- [For ad blocking beyond Safari](#beyond)
- [Contribution](#contribution)
  - [How to report an issue](#issue)
  - [Translating AdGuard](#contribution-translating)
  - [Other options](#contribution-other)
  - [How to become a Beta tester](#beta-tester)
- [Technical documentation](#developers)

AdGuard Mini (formerly AdGuard for Safari) is the same open-source Safari extension — but redesigned, faster, and with advanced features. On top of core ad-blocking power, advanced features are now available as an optional in-app purchase.

AdGuard Mini keeps all kinds of ads away from your Safari browser. It removes all visual clutter, such as banners, popups, and autoplay videos, so only the important content stays. AdGuard Mini also protects your privacy by blocking trackers to prevent unnecessary data collection.

With AdGuard Mini you can manage ad blocking directly from Safari – pause protection, allowlist websites, block elements manually, and report issues.

<a id="key"></a>
## Key features

- Block all kinds of ads in Safari: banners, video ads, popups, autoplay videos, and overlays
- Stop trackers and analytics beacons to protect your privacy
- Eliminate annoyances: cookie notices, social widgets, assistant windows and sticky bars
- Control everything from the Safari toolbar
- Select and block manually any element on a page
- Choose from popular filter lists or add your own
- Create custom filtering rules with an advanced rule editor

<a id="pro"></a>
## Advanced features

* System-wide protection to block ads in supported browsers and apps on your Mac, not just Safari
* Real-time filter updates for precise ad blocking
* AdGuard Extra to handle anti-adblock scripts and complex cases
* Advanced custom filters to add any filters you wish

Advanced features can be unlocked by an AdGuard Ad Blocker license, which can be obtained on our website or through in-app purchase.

<a id="beyond"></a>
## For ad blocking beyond Safari — there is full-fledged AdGuard for Mac

With all of the above being said, there is a solution that is even more effective than AdGuard Mini extension — [AdGuard for Mac](https://adguard.com/adguard-mac/overview.html). It’s an app that:

* provides better filtering quality in some cases (due to the lack of browser API restrictions)
* is not limited regarding the number of filtering rules

You can [try it out for free](https://adguard.com/download.html?os=mac&show=1).

<a id="contribution"></a>
## Contribution

<a id="issue"></a>
### How to report an issue

To report an issue or submit a feature request, [go to the *Issues* section of this repository](https://github.com/AdguardTeam/AdGuardMiniForMac/issues) and click *New issue* there.

>**Note:** for filter-related issues (missed ads, false positives, etc.) click the AdGuard Mini icon in Safari’s toolbar menu and select *Report an issue*, or go to ⚙️→ *Support* → *Report incorrect blocking* in the AdGuard Mini app. Alternatively, use our [reporting tool](https://link.adtidy.org/forward.html?action=report&app=home&from=github).

<a id="contribution-translating"></a>
### Translating AdGuard

If you want to help with AdGuard translations, please learn more about translating our products [here](https://adguard.com/kb/miscellaneous/contribute/translate/program/).

<a id="contribution-other"></a>
### Other options

Here is a [dedicated page](https://adguard.com/contribute.html) for those who are willing to contribute.

<a id="beta-tester"></a>
### How to become a beta tester

You can use TestFlight to participate in the AdGuard Mini for Mac beta-testing program. All necessary information on this topic can be found on the [dedicated page](https://adguard.com/beta.html?platform=mini_mac).

<a id="developers"></a>
## Technical documentation for developers

See [DEVELOPMENT.md](./DEVELOPMENT.md)

Repository info

Default branch: master
Latest version: v3.0.0
Created: 18/09/2018
Last activity: 03/11/2026
License: Other
Open issues: 83
Watchers: 30

Topics

adblock adguard adguard-mini open-source safari safari-extension

Contributors

Mizzick

991 contributions

Blakhard

121 contributions

vityevato

109 contributions

fix-parrot

91 contributions

slvvko

76 contributions